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The Shell 



7.1 Introduction 



When users log into XENIX, they communic&te with the shell command 
interpreter, sh. This interpreter is a XENIX program that supports a very 
powerful command language. Each invocation of this interpreter is called a 
shell; and each shell has one function: to read and execute commands from its 
standard input. 

Because the shell gives the user a high-level language in which to communicate 
with the operating system, XENIX can perform tasks unheard of in less 
sophisticated operating systems. Commands that would normally have to be 
written in a traditional programming language can be written with just a few 
lines in a shell procedure. In other operating systems, commands are executed 
in strict sequence. With XENIX and the shell, commands can be: 

• Combined to form new commands 

• Passed positional parameters 

• Added or renamed by the user 

• Executed within loops or executed conditionally 

• Created for local execution without fear of name conflict with other 
user commands 

• Executed in the background without interrupting a session at a 
terminal 

Furthermore, commands can "redirect" command input from one source to 
another and redirect command output to a file, terminal, printer, or to another 
command. This provides flexibility in tailoring a task for a particular purpose. 



7.2 Basic Concepts 

The shell itself (i.e., the program that reads your commands when you log in or 
that is invoked with the sh command) is a program written in the C language; it 
is not part of the operating system proper, but an ordinary user program. 



7.2.1 How Shells Are Created 

In XENIX, a process is an executing entity complete with instructions, data, 
input, and output. All processes have lives of their own, and may even start (or 
"fork") new processes. Thus, at any given moment several processes may be 
executing, some of which are "children" of other processes. 

Users log into the operating system and are assigned a "shell" from which they 
execute. This shell is a personal copy of the shell command interpreter that is 
reading commands from the keyboard: in this context, the shell is simply 
another process. 

In the XENIX multitasking environment, files may be created in one phase and 
then sent off to be processed in the "background." This allows the user to 
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continue worlcing while programs are running. 

7.2.2 Commands 

The most common way of using the shell is by typing simple commands at your 
keyboard. A timple command is any sequence of arguments separated by 
spaces or tabs. The first argument (numbered zero) specifies the name of the 
command to be executed. Any remaining arguments, with a few exceptions, are 
passed as arguments to that command. For example, the following command 
line might be typed to request printing of the files aUan, barry, and calvin: 

Ipr allan barry calvin 

If the first argument of a command names a file that is executable (as indicated 
by an appropriate set of permission bits associated with that file) and is actually 
a compiled program, the shell, as parent, creates a child process that 
immediately executes that program. If the file is marked as being executable, 
but is not a compiled program, it is assumed to be a shell procedure, i.e., a file of 
ordinary text containing shell command lines. In this case, the shell spawns 
another instance of itself (a 9iib$heU) to read the file and execute the commands 
inside it. 

From the user's viewpoint, compiled programs and shell procedures are 
invoked in exactly the same way. The shell determines which implementation 
has been used, rather than requiring the user to do so. This provides uniformity 
of invocation. 



7.2.3 How the Shell Finds Commands 

The shell normally searches for commands in three distinct locations in the file 
system. The shell attempts to use the command name as given; if this fails, it 
prepends the string^/6tn to the name. If the latter b unsuccessful, it prepends 
/tttr/bin to the command name. The effect is to search, in order, the current 
directory, then the directory /bin, and finally, /iter/ bin. For example, the pr 
and man commands are actually the files /bin/pr and /u$r/bin/man, 
respectively. A more complex pathname may be given, either to locate a file 
relative to the user's current directory, or to access a command with an 
absolute pathname. If a given command name begins with a slash (/) (e.g., 
/ bin/ gort or /emd), the prepending is not performed. Instead, a single attempt 
is made to execute the command as named. 

This mechanism gives the user a convenient way to execute public commands 
and commands in or near the current directory, as well as the ability to execute 
any accessible command, regardless of its location in the file structure. Because 
the current directory is usually searched first, anyone can possess a private 
version of a public command without affecting other users. Similarly, the 
creation of a new public command does not affect a user who already has a 
private command with the same name. The particular sequence of directories 
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searched may be changed by resetting the shell PATH variable. (Shell variables 
are discussed later in this chapter). 



7.2.4 Generation of Argument Lists 

The arguments to commands are very often filenames. Sometimes, these 
filenames have similar, but not identical, names. To take advantage of this 
similarity in names, the shell lets the user specify patterns that match the 
filenames in a directory. If a pattern b matched by one or more filenames in a 
directory, then those filenames are automatically generated by the shell as 
arguments to the command. 

Most characters in such a pattern match themselves, but there are also XENIX 
special characters that may be included in a pattern. These special characters 
are: the star (*), which matches any string, including the null string; the 
question mark (?), which matches any one character; and any sequence of 
characters enclosed within brackets (( and ]), which matches any one of the 
enclosed characters. Inside brackets, a pair of characters separated by a dash 
(-) matches any character within the range of that pair. Thus [a-de] is 
equivalent to [abcde]. 

Examples of metacharacter usage: 

• {Matehe$ all name$ in the current direetorp) 

*temp* (Matehea all name$ containing ^temfT) 

{a-f]* {MatehcB all namet beginning with^^ through^ f) 

*.e {Matchei off name$ ending in ".e") 

/usr/bin/? {Mateke$ aU $ingU-charaeter name$ in /utr/bin) 

This pattern-matching capability saves typing and, more importantly, makes 
it possible to organize information in large collections of files that are named in 
a structured fashion, using common characters or extensions to identify related 
files. 

Pattern matching has some restrictions. If the first character of a filename is a 
period (.), it can be matched only by an argument that literally begins with a 
period. If a pattern does not match any filenames, then the pattern itself b 
printed out as the result of the match. 

Note that directory names should not contain any of the following characters: 

* MI 

If these characters are used, then infinite recursion may occur during pattern 
matching attempts. 
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7.2.5 Quoting Mechanisms 

The characters <, > ,*,?,L and G have special meanings to the shell. To remove 
the special meaning of these characters requires some form of quoting. This is 
done by using single quotation marks O or double quotation marks (") to 
surround a string. A backslash (\) before a single character provides this 
function. (Back quotation marks {") are used only for command substitution in 
the shell and do not hide the special meanings of any characters.) 

All characters within single quotation marks are taken literally. Thus 

echostuffare echo $? $*; Is • | wc ' 
results in the string 

echo $? $•; Is • | wc 

being assigned to the variable echo$tuff, but it does not result in any other 
commands being executed. 

Within double quotation marks, the special meaning of certain characters does 
persist, while all other characters are taken literally. The characters that 
retain their special meaning are the dollar sign ($), the backslash (\), the single 
quotation mark ( '), and the double quotation mark (" ) itself. Thus, within 
double quotation marks, variables are expanded and command substitution 
takes place (both topics are discussed in later sections). However, any 
commands in a command substitution are unaffected by double quotation 
marks, so that characters such as star (*) retain their special meaning. 

To hide the special meaning of the dollar sign ($) and single and double 
quotation marks within double quotation marks, precede these characters with 
a backslash (\). Outside of double quotation marks, preceding a character with 
a backslash is equivalent to placing single quotation marks around that 
character. A backslash (\) followed by a newline causes that newline to be 
ignored and is equivalent to a space. The backslash-newline pair is therefore 
useful in allowing continuation of long command lines. 

Some examples of quoting are shown below : 
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InpMV 


Shell interprets as: 


'» ' 


The back quotation mark ( ' ) 


'fi ' 


The double quotation mark (") 


'>cho one* ' 


the one word " *echo one * 


n t n n 


The double quotation mark (") 


" *echo one * " 


the one word "one" 


» »» 


illegal (expects another ' ) 


one two 


the two words "one" & "two" 


"one two" 


the one word "one two" 


one two ' 


the one word "one two" 


one • two' 


the one word "one * two" 


"one • two" 


the one word "one • two" 


*echo one* 


the one word "one" 



7.3 Redirecting Input and Output 

In general, most commands do not know or care whether their input or output 
is coming from or going to a terminal or a file. Thus, a command can be used 
conveniently either at a terminal or in a pipeline. A few commands vary their 
actions depending on the nature of their input or output, either for efficiency, 
or to avoid useless actions (such as attempting random access I/O on a terminal 
or a pipe). 



7.3.1 Standard Input and Output 

When a command begins execution, it usually expects that three files are 
already open: a "standard input", a "standard output", and a "diagnostic 
output", (also called "standard error"). A number called a^e dacriploris 
associated with each of these files. By convention, file descriptor is associated 
with the standard input, file descriptor 1 with the standard output, and file 
descriptor 2 with the diagnostic output. A child process normally inherits these 
files from its parent; all three files are initially connected to the terminal (0 to 
the keyboard, 1 and 2 to the terminal screen). The shell permits the files to be 
redirected elsewhere before control is passed to an invoked command. 

An argument to the shell of the form "<fiU" or '*>fUe" opens the specified file 
as the standard input or output (in the case of output, destroying the previous 
contents of file, if any). An argument of the form ">>file" directs the 
standard output to the end o{ file, thus providing a way to append data to the 
file without destroying its existing contents. In either of the two output cases. 
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the shell creates /i/e if it does not already exist. Thus 

> output 

alone on a line creates a zero-length Ble. The following appends to file log the 
list of users who are currently logged on: 

who >> log 

Such redirection arguments are only subject to variable and command 
substitution; neither blank interpretation nor pattern matching of filenames 
occurs after these substitutions. This means that 

echo 'this is a test' > '.gal 

produces a one- line file named *.gal. Similarly, an error message b produced by 
the following command, unlessyou have a file with the name "?": 

cat < ? 

So remember, special characters are not expanded in redirection arguments. 
The reason this is so is that redirection arguments are scanned by the shell 
before pattern recognition and expansion takesplace. 

7.3.2 Diagnostic and Other Outputs 

Diagnostic output from XENIX commands is normally directed to the file 
associated with file descriptor 2. (There is often a need for an error output file 
that is different from standard output so that error messages do not get lost 
down pipelines.) You can redirect this error output to a file by immediately 
prepending the number of the file descriptor (2 in this case) to either output 
redirection symbol (> or >>). The following line appends error messages 
from the cc command to the file named ERRORS: 

cc testfile.c 2>>ERR0RS 

Note that the file descriptor number must be prepended to the redirection 
symbol votthout any intervening spaces or tabs; otherwise, the number will be 
passed as an argument to the command. 

This method may be generalized to allow redirection of output associated with 
any of the first ten file descriptors (numbered 0-9). For instance, if cm^puts 
output on file descriptor 9, then the following line will direct that output to the 
file save (fat a: 

cmd 9>savedata 

A command often generates standard output and error output, and might even 
have some other output, perhaps a data file. In this case, one can redirect 
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independently all the different outputs. Suppose, for example, that em^ directs 
its standard output to file descriptor 1, its error output to file descriptor 2, and 
builds a data file on file descriptor 0. The following would direct each of these 
three outputs to a different file: 

cmd >standard 2>error 6>data 



7.3.3 Command Lines and Pipelines 

A sequence of commands separated by the vertical bar ( | ) makes up a pipeline . 
In a pipeline consisting of more than one command, each command is run as a 
separate process connected to its neighbors by pipet, that is, the output of each 
command (except the last one) becomes the input of the next command in line. 

Afilteris a command that reads its standard input, transformsit in some way, 
then writes it as its standard output. A pipeline normally consists of a series of 
filters. Although the processes in a pipeline are permitted to execute in parallel, 
each program needs to read the output of its predecessor. Many commands 
operate on individual lines of text, reading a line, processing it, writing it out, 
and looping back for more input. Some must read large amounts of data before 
producing output; sort is an example of the extreme case that requires all input 
to be read before any output is produced. 

The following is an example of a typical pipeline: 

nroff -mm text | col | Ipr 

NroflTis a text formatter available in the XENIX Text Processing System whose 
output may contain reverse line motions, col converts these motions to a form 
that can be printed on a terminal lacking reverse-motion capability, and Ipr 
does the actual printing. The flag -mm indicates one of the commonly used 
formatting options, and tett 'is the name of the file to be formatted. 

The following examples illustrate the variety of effects that can be obtained by 
combining a few commands in the ways described above. It may be helpful to 
try these at a terminal: 

• who 

Prints the list of logged-in users on the terminal screen. 

• who > > log 

Appends the list of logged-in users to the end of file log. 

• who I wc -1 

Prints the number of logged-in users. (The argument to wc b 
pronounced "minus ell".) 
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• who I pr 

Prints a paginated list of logged- in users. 

• who I sort 

Prints an alphabetized listof logged-in users. 

• who I grep bob 

Prints the list of logged-in users whose login names contain the string 
bob. 

• who j grep bob | sort | pr 

Prints an alphabetized, paginated list of logged-in users whose login 
names contain the string bob . 

• { date; who j wc -1 ; }>>log 

Appends {to file log) the current date followed by the count of logged- 
in users. Be sure to place a space after the left brace and a semicolon 
before the right brace. 

• who|sed-c 's/ .*// '|sort|uniq-d 

Prints only the login names of all users who are logged in more than 
once. Note the use of sed as a filter to remove characters trailing the 
login name from each line. (The ".*" in the sed command is preceded 
by a space.) 

The who command does not by iteelf provide options to yield all these 
results — they are obtained by combining who with other commands. Note 
that who just serves as the data source in these examples. As an exercise, 
replace "who | " with "</etc/passwd" in the above examples to see how a file 
can be used as a data source in the same way. Notice that redirection 
arguments may appear anywhere on the command line, even at the start. This 
means that 

<infile >outfile sortjpr 

is the same as 

sort|pr <infile >outfiIe 



7.3.4 Command Substitution 

Any command line can be placed within back quotation marks (\ . /) so that 
the output of the command replaces the quoted command line itself. This 
concept is known as command eubetitution. The command or commands 
enclosed between back quotation marks zu'e first executed by the shell and then 
their output replaces the whole expression, back quotation marks and all. This 
feature is often used to assign to shell variables. (Shell variables are described 
in the next section.) For example, 
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today BB^d ate* 

assigns the string representing the current date to the variable "today"; for 
example "Tue Nov 27 16:01:09 EST 1082". The following command saves the 
number of logged-in users in the shell variable u»er$ : 

users^'who | wc -1' 

Any command that writes to the standard output can be enclosed in back 
quotation marks. Back quotation marks may be nested, but the inside sets 
must be escaped with backslashes ( \ ). For example: 

logmsg«B'echo Your login directory is \'pwd\** 

will display the line "your login directory is name cf login directory". Shell 
variables can abo be given values indirectly by using the read and line 
commands. The read command takes a line from the standard input (usually 
your terminal) and assigns consecutive words on that line to any variables 
named. 

For example, 

read first init last 
takes an input line of the form 

G. A. Snyder 
and has the same effect as typing: 

firstaBG. initssA. last=«Snyder 

The read command assigns any excess "words" to the last variable. 

The line command reads a line of input from the standard input and then 
echoes it to the standard output. 

7.4 Shell Variables 

The shell has several mechanisms for creating variables. A variable is a name 
representing a string value. Certain variables are referred to as poiitional 
parafnettr$\ these are the variables that are normally set only on the command 
line. Other shell variables are simply names to which the user or the shell itself 
may assign string values. 
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7.4.1 Positional Parameters 

When a shell procedure is invoked, the shell implicitly creates po$itiond 
parametere. The name of the shell procedure itself in position lero on the 
command line is assigned to the positional parameter $0. The first command 
argument is called $1, and so on. The shift command may be used to access 
arguments in positions numbered higher than nine. For example, the following 
shell script might be used to cycle through command line switches and then 
process all succeeding files: 

while test '$1 ' 

do case $1 in 

-a) Aaeaoption ; shift ;; 

-b) Basboption ; shift ;; 

-c) G»coption ; shift ;; 

-*) echo "bad option" ; exit 1 ;; 

*) process rest of files 

esac 
done 

One can explicitly force values into these positional parameters by using the set 
command. For example, 

set abc def ghi 

assigns the string "abc" to the first positional parameter, $1, the string "def to 
$2, and the string "ghi" to $3. Note that $0 may not be assigned a value in this 
way — it always refers to the name of the shell procedure; or in the login shell, to 
the name of the shell. 



7.4.2 User-Defined Variables 

The shell also recognizes alphanumeric variables to which string values may be 
assigned. A simple assignment has the syntax: 

namesa$tring 

Thereafter, tname will yield the value string. A name is a sequence of letters, 
digits, and underscores that begins with a letter or an underscore. No spaces 
surround the equal sign (ss) in an assignment statement. Note that positional 
parameters may not appear on the left side of an assignment statement; they 
can only be set as described in the previous section. 

More than one assignment may appear in an assignment statement, but 
beware: the ehell performs the aeeignments from right to left. Thus, the 
following command line results in the variable "A" acquiring the value "abc": 
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A-$B Bi-abc 

The following are examples of simple assignments. Double quotation marks 
around the right-hand side allow spaces, tabs, semicolons, and newlines to be 
included in a string, while abo allowing variable substitution (also known as 
"parameter substitution") to occur. This means that references to positional 
parameters and other variable names that are prefixed by a dollar ngn ($) are 
replaced by the corresponding values, if any. Single quotation marks inhibit 
variable substitution: 

MAIL>B/usr/mail/gas 
echovar-^echo $1 $2 $3 |4" 
stars—***** 
asterisksav'Sstars* 

In the above example, the variable "echovar" has as its value the string 
consisting of the values of the first four positional parameters, separated by 
spaces, plus the string "echo". No quotation marks are needed around the 
string of asterisks being assigned to $tar$ because pattern matching (expansion 
of star, the question mark, and brackets) does not apply in this context. Note 
that the value o(taiteri$k$ is the literal string "Istars", not the string "«•••*", 
because the single quotation marks inhibit substitution. 

In assignments, spaces are not re-interpreted after variable substitution, so 
that the following example results in tfir$t and $«ee9nif having the same value: 

firstsB a string with embedded spices' 
second xB$first 

In accessing the values of variables, you may enclose the variable name in 
braces {...} to delimit the variable name from any following string. In 
particular, if the character immediately following the name is a letter, digit, or 
underscore, then the braces are required. For example, examine the following 
input: 

a= 'This is a string ' 

echo "${a}ent test of variables." 

Here, the echo command prints: 

This is a stringent test of variables. 

If no braces were used, the shell would substitute a null value for "laent" and 
print: 

test of variables. 
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The following variables are maintained by the shell. Some of them are set by 
the shell, and all of them can be reset by the user: 

HOME Initialized by the login program to the name of the user's login 
directory, that is, the directory that becomes the current 
directory upon completion of a login; cd without arguments 
switches to the $HOME directory. Using this variable helps keep 
full pathnames out of shell procedures. This is of great benefit 
when pathnames are changed, either to balance disk loads or to 
reflect administrative changes. 

IFS The variable that specifies which characters are interred field 

$eparator$. These are the characters the shell uses during blank 
interpretation. (If you want to parse some delimiter-separated 
data easily, you can set IFS to include that delimiter.) The shell 
initially sets IFS to include the blank, tab, and ne wline characters. 

MAIL The pathname of a file where your mail is deposited. If MAIL b 
set, then the shell checks to see if anything has been added to the 
file it names and announces the arrival of new mail each time you 
return to command level (e.g., by leaving the editor). MAIL must 
be set by the user and "exported". (The export command b 
discussed later in this chapter.) (The presence of mail in the 
standard mail file b also announced at login, regardless of whether 
MAE. b set.) 

PATH The variable that specifies the search path used by the shell in 
finding commands. Its value is an ordered list of directory 
pathnames separated by colons. The shell initializes PATH to the 
list :/bin:/u$r/bin where a null argument appears in front of the 
first colon. A null anywhere in the path list represents the current 
directory. On some systems, a search of the current directory b 
not the default and the PATH variable is initialized instead to 
/bin:/u$r/bin. If you wbh to search your current directory last, 
rather than first, use: 

PATH— /bin:/usr/bin:: 

Here, the two colons together represent a colon followed by a null, 
followed by a colon, thus naming the current directory. You could 
possess a personal directory of commands (say, tHOME/bin) and 
cause it to be searched before the other three directories by using: 

PATH=$HOME/bin::/bin:/usr/bin 

"PATH" is normally set in your .profile file. 

PSl The variable that specifies what string is to be used as the primary 
prompt string. If the shell is interactive, it prompts with the value 
of PSl when it expects input. The default value of PSl b "$ " (a 
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dollar sign ($) followed by a blank). 

PS2 The variable that specifies the secondary prompt string. If the 
shell expects more input when it encounters a newline in its input, 
it prompts with the value of PS2. The default value for thb 
variable is"> " (a greater- than ^mbol followed by aspace). 

In general, you should be sure to export all of the above variables so that their 
values are passed to all shells created from your login. Use export at the end of 
your .profile file. An example of an export statement follows: 

export HOME IFS MAIL PATH PSl PS2 



7.4.3 Predefined Special Variables 

Several variables have special meanings; the following are set on/y by the shell: 

|# Records the number of arguments passed to the shell, not counting 
the name of the shell procedure itself. For instance, l# yields the 
number of the highest set positional parameter. Thus 

sh cmd a b c 

automatically sets $# to 3. One of its primary uses b in checking for 
the presence of the required number of arguments: 

if test $# -It 2 
then 

echo 'two or more args required '; exit 
fi 

I? Contains the exit status of the last command executed (also referred 
to as "return code", "exit code", or "value"). Its value is a decimal 
string. Most XENIX commands return sero to indicate successful 
completion. The shell itself returns the current value of $? as its exit 
status. 

1$ The process number of the current process. Because process 
numbers are unique among all existing processes, this string is often 
used to generate unique names for temporary files. XENIX provides 
no mechanism for the automatic creation and deletion of temporary 
files; a file exists until it is explicitly removed. Temporary files are 
generally undesirable objects; the XENIX pipe mechanism is far 
superior for many applications. However, the need for uniquely- 
named temporary files does occasionally occur. 

The following example illustrates the recommended practice of 
creating temporary files; note that the directories /««rand /u$r/imp 
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are cleared out if the system is rebooted. 

# use current process id 

# to form unique temp file 
teinp-=»/usr/temp/$$ 

b > $temp 

# commands here, some of which use Itemp 
rm Itemp 

# clean up at end 

$! The process number of the last process run in the background (using 
the ampersand (&)). This b a string containing from one to five 
digits. 

$- A string consisting of names of execution flags currently turned on in 
the shell. For example, $- might have the value "xv" if you are 
tracingyour output. 



7.5 The Shell State 

The state of a given instance of the shell includes the values of positional 
parameters, user-defined variables, environment variables, modes of 
execution, and the current working directory. 

The state of a shell may be altered in various ways. These include changing the 
working directory with the cd command, setting several flags, and by reading 
commands from the special file, .profile , in your login directory. 



7.5.1 Changing Directories 

The cd command changes the current directory to the one specified as ite 
argument. This can and should be used to change to a convenient place in the 
directory structure. Note that cd is often placed within parentheses to cause a 
subshell to change to a different directory and execute some commands without 
afl'ecting the original shell. 

For example, the first sequence below copies the file letc/pa$etoi to 
/u$r/yon/pa$$wd; the second example first changes directory to /etc and then 
copies the file: 

cp /etc/passwd /usr/you/bin/passwd 
(cd /etc ; cp passwd /usr/you/passwd) 

Note the use of parentheses. Both command lines have the same effect. 
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7.5.2 The .pro81e File 

The file named . profile is read each time you log in to XENIX. It is normal^ used 
to execute special one-time-only commands and to set and export variables to 
all later shells. Only after commands are read and executed from .profile, does 
the shell read commands from the standard input — usually the terminal. 



7.5.3 Execution Flags 

The set command lets you alter the behavior of the shell by setting certain shell 
flags. In particular, the -x and -v flags may be useful when invoking the shell 
as a command from the terminal. The flags -x and -v may be set by typing: 

set -XV 
The same flags may be turned ojf by typing: 

set +XV 

These two flags have the following meaning: 

-V Input lines are printed as they are read by the shell. This flag is 
particularly useful for isolating syntax errors. The commands on 
each input line are executed after that input line b printed. 

-X Commands and their arguments are printed as they are executed. 
(Shell control commands, such as for, while, etc., are not printed, 
however.) Note that-x causes a trace of only those commands that 
are actually executed, whereas -v prints each line of input until a 
syntax error is detected. 

The set command is also used to set these and other flags within shell 
procedures. 

7.6 A Command's Environment 

All variables and their associated values that are known to a command at the 
beginning of its execution make up its environment. This environment 
includes variables that the command inherits from its parent process and 
variables specified as keyword parameter$ on the command line that invokes 
the command. 

The variables that a shell passes to its child processes are those that have been 
named as arguments to the export command. The export command places 
the named variables in the environments of both the shell an<f all itsfuture child 
processes. 
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Keyword parameters are variable-value pairs that appear in the form of 
assignments, normally before the procedure name on a command line. Such 
variables are placed in the environment of the procedure being invoked. For 
example: 

# keycommand 

echo $a $b 

This is a simple procedure that echoes the values of two variables. If it is 
invoked as: 

aaskeyl b«»key2 keycommand 

then the resulting output is: 

keyl key 2 

Keyword parameters are not counted as arguments to the procedure and do not 
affect $#. 

A procedure may access the value of any variable in its environment. However, 
if changes are made to the value of a variable, these changes are not reflected in 
the environment; they are local to the procedure in question. In order for these 
changes to be placed in the environment that the procedure passes to it$ child 
processes, the variable must be named as an argument to the export command 
within that procedure. To obtain a list of variables that have been made 
exportable from the current shell, type: 

export 

You will abo get a Ibt of variables that have been made readonly. To get a list 
of name-value pairs in the current environment, type either 

printenv 

or 

env 



7.7 Invoking the Shell 

The shell is a command and may be invoked in the same way as any other 
command: 

shproc[ ary...] A new instance of the shell is explicitly invoked to 

read proe. Arguments, if uiy, can be 
manipulated. 
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sh-v proc [arg...] This is equivalent to putting "set -v" »t the 

beginning of proe. It can be used in the same way 
for the -X, -e, -u, and -n flags. 

proe [ arg ... ] If proe is an executable file, and is not a compiled 

executable program, the effect is similar to that 
of: 

sh proc args 

An advantage of this form is that variables that 
have been exported in the shell will still be 
exported from proe when this form is used 
(because the shell only forks to read commands 
from proe). Thus any changes made within proe 
to the values of exported variables will be passed 
on to subsequent commands invoked from proe . 



7.8 Passing Arguments to Shell Procedures 

When a command line is scanned, any character sequence of the form $n b 
replaced by the nth argument to the shell, counting the name of the shell 
procedure itself as $0. This notation permits direct reference to the procedure 
name and to as many as nine pointional parameters. Additional arguments can 
be processed using the shift command or by using a for loop. 

The shift command shifts arguments to the left; i.e., the value of $1 is thrown 
away, $2 replaces $1, $3 replaces $2, and so on. The highest- numbered 
positional parameter becomes un$et ($0 is never shifted). For example, in the 
shell procedure ripple below, echo writes its arguments to the standard output. 

# ripple command 

while test $# !a> 

do 

echo $1 $2 $3 $4 $5 $6 $7 $8 $9 

shift 
done 

Lines that begin with a number sign (#) are comments. The looping command, 
while, is discussed in Section 7.9.3 of this chapter. If the procedure were 
invoked with 

ripple a b c 

it would print: 
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a b c 

be 

c 



The special shell variable "star" ($*) causes substitution of all positional 
parameters except $0. Thus, the echo line in the ripple example above could be 
written more compactly as: 

echo $* 

These two echo commands are not equivalent: the first prints at most nine 
positional parameters; the second prints ail of the current positional 
parameters. The shell star variable ($*) is more concise and less error-prone. 
One obvious application is in passing an arbitrary number of arguments to a 
command: For example 

wc$* 

counts the words of each of the files named on the command line. 

It is important to understand the sequence of actions used by the shell in 
scanning command lines and substituting arguments. The shell first reads 
input up to a newline or semicolon, and then parses that much of the input. 
Variables are replaced by their values and then command substitution (via 
back quotation marks) is attempted. I/O redirection arguments are detected, 
acted upon, and deleted from the command line. Next, the shell scans the 
resulting command line for internal field $eparator$f that is, for any characters 
specified by IFS to break the command Ime into distinct arguments; explicit 
null arguments (specified by "" or ") are retained, while implicit null 
arguments resulting from evaluation of variables that are null or not set are 
removed. Then filename generation occurs with all metacharacters being 
expanded. The resulting command line is then executed by the shelL 

Sometimes, command lines are built inside a shell procedure. In this case, it is 
sometimes useful to have the shell rescan the command line after all the initial 
substitutions and expansions have been performed. The special command eval 
is available for this purpose. Eval takes a command line as its argument and 
simply rescans the line, performing any variable or command substitutions 
that are specified. Consider the following (simplified) situation: 

commandaswho 
outputss 'I wc -1' 
eval Icommand Soutput 

This segment of code results in the execution of the command line 

who I wc -1 

The output of eval cannot be redirected. However, uses of eval can be nested, 
so that a command line can be evaluated several times. 
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7.9 Controlling the Flow of Control 

The shell provides several commands that implement a variety of control 
structures useful in controlling the flow of control in shell procedures. Before 
describing these structures, a few terms need to be defined. 

A $imple commandis any single irreducible command specified by the name of 
an executable file. I/O redirection arguments can appear in a simple command 
line and are passed to the shell, not to the command. 

A command is a simple command or any of the shell control commands 
described below. A pipeline is a sequence of one or more commands separated 
by vertical bars ( | }. In a pipeline, the standard output of each command but 
the last is connected (by a pipe) to the standard input of the next command. 
Each command in a pipeline is run separately; the shell waits for the last 
command to finish. The exit status of a pipeline is nonzero if the exit status of 
either the first or last process in the pipeline is nonzero. 

A c ommand liet is a sequence of one or more pipelines separated by a semicolon 
(;), an ampersand (&), an "and-if symbol (&&), or an "or-ir* ( || ) symbol, and 
optionally terminated by a semicolon or an ampersand. A semicolon causes 
sequential execution of the previous pipeline. This means that the shell waits 
for the pipeline to finish before reading the next pipeline. On the other hand, 
the ampersand (&) causes asynchronous background execution of the 
preceding pipeline. Thus, both sequential and background execution are 
allowed. A background pipeline continues execution until it terminates 
voluntarily, or until its processes are killed. 

Other uses of the ampersand include off-line printing, background 
compilation, and generation of jobs to be sent to other computers. For 
example, if you type 

nohup cc prog.c& 

you may continue working while the C compiler runs in the background. A 
command line ending with an ampersand is immune to interrupts or quits that 
you might generate by typing INTERRUPT or QUIT. It is also immune to 
logouts with CNTRL-D. However, CNTRL-D will abort the command if you are 
operating over a dial-up line. In this case, it is wise to make the command 
immune to hang-ups (i.e., logouts) as well. The nohup command is used for 
this purpose. In the above example without nohup, if you logout from a dial- 
up line while cc is still executing, cc will be killed and your output will 
disappear. 

The ampersand operator should be used with restraint, especially on heavily- 
loaded systems. Other users will not consider you a good citizen if you start up 
a large number of background processes without a compelling reason for doing 
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The and-if and or-if {&,& and 1 1 ) operators cause conditional execution of 
pipelines. Both of these are of equal precedence when evaluating command 
lines (but both are lower than the ampersand (&) and the vertical bar ( | )). In 
the command line 

cmdl II cmd2 

the first command, emdl, is executed and its exit status examined. Only if 
emdl fails (i.e., has a nonzero exit status) is cm</^ executed. Thus, this is a more 
terse notation for: 

if cmdl 

test $? !— 
then 

cmd2 
fi 

The and-if operator (&&) operator yields a complementary test. For example, 
in the following command line 

cmdl &&. cmd2 

the second command is executed only if the first $ueeeei$ (and has a zero exit 
status). In the sequence below, each command is executed in order until one 
fails: 

cmdl &,&. cmd2 && cmd3 &&. ... &St cmdn 

A simple command in a pipeline may be replaced by a command list enclosed in 
either parentheses or braces. The output of all the commands so enclosed is 
combined into one stream that becomes the input to the next command in the 
pipeline. The following line formats and prints two separate documents: 

{ nroff -mm textl; nroff -mm text2; } | Ipr 

Note that a space is needed after the left brace and that a semicolon should 
appear.before the right brace. 



7.0.1 Using the if Statement 

The shell provides structured conditional capability with the if command. The 
simplest if command has the following form: 

if eommand-litt 
then eommand-ltBt 
fi 

The command list following the if is executed and if the last commandin the list 
has a zero exit status, then the command list that follows then is executed. The 
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word fi indicates the end of the if command. 

To cause an alternative set of commands to be executed when there is anoniero 
exit status, an else clause can be given with the following structure: 

if command-li$t 
then eommand-li$t 
else eommand-liit 
fi 

Multiple tests can be achieved in an if command by using the elif clause, 
although the case statement (See Section 7.9.2) b better for large numbers of 
tests. For example: 



if 


test-f"$r 








# 








is $1 a file? 


then 


pr$l 








elif 


test -d *$r 








# 








else, is $1 a directory? 


then 


(cd 11; pr •) 








else 


echo $1 is neither 


a file 


nor a 


directory 


fi 











The above example is executed as follows: if the value of the first positional 
parameter is a filename (-f), then print that file; if not, then check to see if it b 
the name of a directory (-d). If so, change to that directory (cd) and print all the 
files there (pr*). Otherwbe, echo the error message. 

The if command may be nested (but be sure to end each one with a fi). The 
newlines in the above examples of if may be replaced by semicolons. 

The exit status of the if command b the exit status of the last command 
executed in any then clause or else clause. If no such command was executed, 
if returns a sero exit status. 

Note that an alternate notation for the test command uses brackets to enclose 
the expression being tested. For example, the previous example might have 
been written as follows: 

if I -f "$1" I 

# b $1 a file? 
then pr $1 

elif ( -d "$r J 

# else, b $1 a directory? 
then (cd $1; pr *) 

else echo $1 is neither a file nor a directory 

fi 

Note that a space after the left bracket and one before the right bracket are 
essential in thisform of the syntax. 
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7.fl.2 Using the case Statement 

A multiple test conditional is provided by the case command. The bane 
formatofthec ase stateme nt b: 

case $tring in 

pattern ) command-U$t ;; 

pattern ) eommand-li$t ;; 
esac 

The shell tries to match tiring against each pattern in turn, using the same 
pattern*matching conventions as in filename generation. If a match is found, 
the command list following the matched pattern is executed; the double 
semicolon (;;) serves as a break out of the case and is required after each 
command list except the last. Note that only one pattern b ever matched, and 
that matches are attempted in order, so that if a star (•) is the first pattern in a 
case, no other patterns are looked at. 

More than one pattern may be associated with a given command Ibt by 
specifying alternate patterns separated by vertical bars ( | ). 

case $i in 

*.c) cc li 

♦.h I ♦.sh) 

: do nothing 

i» 
*) echo "li of unknown ^pe" 

esac 

In the above example, no action is taken for the second set of patterns because 
the null, colon (:) command is specified. The star (*) b used as a default pattern, 
because it matches any word. 

The exit status of case is the exit status of the last command executed in the 
case command. If no commands are executed, then case has a zero exit status. 



7.0.3 Conditional Looping: while and until 

A while command has the general form: 

while €0mmand4i$t 
do 

command-litt 
done 
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The commands in the first eommand-U$t are executed, and if Uie exit status of 
the last command in that list is sero, then the commands in the second 
ecmmand-liit are executed. This sequence is repeated as long as the exit status 
of the first eommand-liBt is zero. A loop can be executed as long as the first 
command-list returns a nonzero exit status by replacing while with until. 

Any newline in the above example may be replaced by a semicolon. The exit 
status of a while (or until) command is the exit status of the last command 
executed in the second eotnmand-li$t. If no such command is executed, while 
(or until) has a zero exit status. 



7.0.4 Looping Over a List: for 

Often, one wishes to perform some set of operations for each file in a set of files, 
or execute some command once for each of several arguments. The for 
command can be used to accomplish this. The for command has the format: 

for variable in v>ord-li$t 
do 

c«mtnand-li$t 
done 

Here v>ord-li$t is a list of strings separated by blanks. The commands m the 
eommand'li$t are executed once for each word in the word'U$t. Variable takes 
on as its value each word from the word list, in turn. The word list is fixed after 
it is evaluated the first time. For example, the following for loop causes each of 
the C source files xee.e, emd.e, and vord.c in the current directory to be 
compared with a file of the same name in the directory /utr/tre/emd/Bh: 

for CFELE in xec cmd word 

do diff ${CFILE}.c /usr/src/cmd/sh/l{CFILE}.c 

done 

Note that the first occurrence of CFELE immediately after the word for has no 
preceding dollar sign, since the name of the variable is wanted and not its value. 

You can omit the "in word-liet" part of a for command; this causes the 
current set of positional parameters to be used in place of word-l'ist. This is 
useful when writing a command that performs the same set of commands for 
each of an unknown number of arguments. Create a file named echoS that 
contains the following shell script: 

for word 

do echo twordiword 

done 

Give eehoSextcute status: 
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chmod -t-x echo2 
Now type the following command: 

echo2 ma pa bo fi yo no so ta 

The output from this command is: 

mama 

papa 

bobo 

fifi 

yoyo 

nono 

soso 

tata 

7.0.5 Loop Control: break and continue 

The break command can be used to terminate execution of a while or a for 
loop. Continue requests the execution of the next iteration of the loop. These 
commands are effective only when they appear between do and done. 

The break command terminates execution of the smallest (i.e., innermost) 
enclosing loop, causing execution to resiune after the nearest following 
unmatched done. Exit from n levels is obtained by break n. 

The continue command causes execution to resume at the nearest enclosing 
for, while, or until statement, i.e., the one that begins the innermost loop 
containing the continue. You can also specify an argument it to continue and 
execution will resume at the nth enclosing loop: 



7-24 



The Shell 



i^ This procedure is interactive. 

# "Break" and "continue" commands are used 

# to allow the user to control data entry, 
while true #loop forever 

do echo "Please enter data" 

read response 
case "Iresponse" in 
"done") 



break 

# no more data 

55 

# just a carriage return, 

# keep on going 
continue 

»t 

# process the data here 



done 



7.0.6 End-of-File and exit 

When the shell reaches the end-of-file in a shell procedure, it terminates 
execution, returning to its parent the exit status of the last command executed 
prior to the end-of>file. The top level shell is terminated by typing a CNTRL-D 
which is the same as logging out. 

The exit command simply reads to the end-of-file and returns, setting the exit 
status to the value of its argument, if any. Thus, a procedure can be terminated 
normally by placing "exit 0" at the end of the file. 



7.0.7 Command Grouping: Parentheses and Braces 

There are two methods for grouping commands in the shell: parentheses and 
braces. Parentheses cause the shell to create a subshell that reads the enclosed 
commands. Both the right and left parentheses are recognized wherever they 
appear in a command line — they can appear as literal parentheses oa/ywhen 
enclosed in quotation marks. For example, if you type 

garble(stuff) 

the shell prints an error message. Quoted lines, such as 

garble" ("stuff")" 
"garble(stufl)" 

are interpreted correctly. Other quoting mechanisms are discussed in section 
7.2.3.2, "Quoting Mechanisms". 
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This capability of creating a subshell by grouping commands is useful when 
performing operations without affecting the values of variables in the current 
shell, or when temporarily changing the working directory and executing 
commands in the new directory without having to return to the current 
directory. 

The current environment is passed to the subshell and variables that arc 
exported in the current shell are also exported in the subshell Thus 

CURRENTDIR— >wd^ cd /usr/docs/otherdir; 
nohup nroff doc.n | lpr& ; cd ICURRENTDIR 

and 

(cd /usr/docs/otherdir; nohup nroff doc.n | lpr&) 

accomplish the same result: a copy of /u$r/doei/otherdir/doe.n is sent to the 
lineprtnter. (Note that nroff is a command available in the XENIX Text 
Processing System.) However, the second example automatically putsyou back 
in your original working directory. In the second example above, blanks or 
newlines surrounding the parentheses are allowed but not necessary. When 
entering a command line at your terminal, the shell will prompt with the value 
of the shell variable PS2 if an end parenthesis is expected. 

Braces ({ and }) may also be used to group commands together. Both the left 
and the right brace are recognized only if they appear as the first (unquoted) 
word of a command. The opening brace' may be followed by a newline (in which 
case the shell prompts for more input). Unlike parentheses, no subshell is 
created for braces: the enclosed commands are simply read by the shell. The 
braces are convenient when you wish to use the (sequential) output of several 
commands as input to one commaitd. 

The exit status of a set of commands grouped by either parentheses or braces is 
the exit status of the last enclosed executed command. 



7.0.8 Input/Output Redirection and Control Commands 

The shell normally does not fork and create a new shell when it recognizes the 
control commands (other than parentheses) described above. However, each 
command in a pipeline is run as a separate process in order to direct input to or 
output from each command. Also, when redirection of input or output is 
specified explicitly to a control command, a separate process is spawned to 
execute that command. Thus, when if, while, until, case, and for are used in 
a pipeline consisting of more than one command, the shell forks and a subdiell 
runs the control command. This has two implications: 



1. Any changes made to variables within the control command are not 
effective once that control command finishes (this is similar to the 
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effect of using parentheses to group commands). 

Control commands run slightly slower when redirected, because of 
the additional overhead of creating a shell for the control command. 



7.0.0 Transfer to Another File and Back: The Dot (.) Command 

A command line of the form 

. proc 

causes the shell to read commands from proe without spawning a new process. 
Changes made to variables in proe are in effect after the dot command finishes. 
This is a good way to gather a number of shell variable mitialixations into one 
file. A common use of this command is to reinitialize the top level shell by 
reading the .profile file with: 

. .profile 

7.0.10 Interrupt Handling: trap 

Shell procedures can use the trap command to disable a signal (cause it to be 
ignored), or redefine its action. The form of the trap command is: 

trap arg $ignal'li$t 

Here arg b a string to be interpreted as a command list and $tgnal-li$t consbts 
of one or more signal numbers as described in iigntd{S)) in the XENIX Reference 
Manual. The most important of these signals follow: 



Number Signal 

00 KILL (CNTRL-U) 

01 HANGUP 

02 INTERRUPT character 

03 QUIT 

00 KILL (cannot be caught or ignored) 

11 segmentation violation (cannot be caught or ignored) 

15 software termination signal 



The commands in arg are scanned at least once, when the shell first encounters 
the trap command. Because of thb, it is usually wise to use single rather than 
double quotation marks to surround these commands. The former inhibit 
immediate command and variable substitution. This becomes important, for 
instance, when one wishes to remove temporary files and the names of those 
files have not yet been determined when the trap command is first read by the 
shell. The following procedure will print the name of the current directory in 
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the file errdirect when it is interrupted, thus giving the user information as to 
how much of the job was done: 

trap echo *pwd' >errdirect'2 3 15 
for i in /bin /usr/bin /usr /gas/bin 
do 

cdii 
# commands to be executed in directory $i here 
done 

Beware that the same procedure with double rather than single quotation 
marks does something different. The following prints the name of the directory 
from which the procedure was first executed: 

(trap "echo *pwd* > errdirect" 2 3 15) 

A signal 1 1 can never be trapped, because the shell itself needs to catch it to deal 
with memory allocation. Zero is interpreted by the trap command as a signal 
generated by exiting from a shell. This occurs either with an exit command, or 
by "falling through" to the end of a procedure. If arg is not specified, then the 
action taken ui>on receipt of any of the signals in the signal list is reset to the 
default system action. If arg is an explicit null string ( "or "" ), then the signals 
in the signal list are ignored by the shell. 

The trap command is most frequently used to make sure that temporary files 
are removed upon termination of a procedure. The preceding example would 
be written more typically as follows: 

tempn|HOME/temp/$$ 

trap rm Stemp; trap 0; exit ' 1 2 3 15 

Is > Itemp 

# commands that use $temp here 

In this example, whenever signal 1 (hangup), 2 (interrupt), 3 (quit), or 15 (kill) is 
received by the shell procedure, or whenever the shell procedure is about to 
exit, the commands enclosed between the single quotation marks are executed. 
The exit command must be included, or else the diell continues reading 
commands where it left off when the signal was received. The "trap 0" in the 
above procedure turns off the original traps 1, 2, 3, and 15 on exits from the 
shell, so that the exit command does not reactivate the execution of the trap 
commands. 

Sometimes the shell continues reading commands after executing trap 
commands. The following procedure takes each directory in the current 
directory, changes to that directory, prompts with its name, and executes 
commands typed at the terminal until an end-of-file (CNTRL-D) or an interrupt 
is received. An end-of-file causes the read command to return a nonzero exit 
status, and thus the while loop terminates and the next directory cycle is 
initiated. An interrupt is ignored while executing the requested commands, but 
causes termination of the procedure when it is waiting for input: 
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for i in* 

do if test -d $d/$i 

then cd $d/$i 

while echo "$i:" 
trap exit 2 
read x 
do trap : 2 



# ignore interrupts 
eval $x 



done 
fi 
done 



Several traps may be in effect at the same time: if multiple signals are received 
simultaneously, they are serviced in numerically ascending order. To 
determine which traps are currently set, type: 

trap 

It is important to understand some things about the way in which the shell 
implements the trap command. When a signal (other than 11) is received by 
the shell, it is passed on to whatever child processes are currently executing. 
When these (synchronous) processes terminate, normally or abnormally, the 
shell polls any traps that happen to be set and executes the appropriate trap 
commands. This process is straightforward, except in the case of traps set at 
the command (outermost, or login) level. In this case, it is possible that no child 
process is running, so before the shell polls the traps, it waits for the 
termination of the first process spawned s/ter the signal was received. 

When a signal is redefined in a shell script, this does not redefine the signal for 
programs invoked by that script; the signal is merely passed along. A disabled 
signal is not passed. 

For internal commands, the shell normally polls traps on completion of the 
command. An exception to this rule is made for the read command, for which 
traps are serviced immediately, so that read can be interrupted while waiting 
for input. 



7.10 Special Shell Commands 

There are several special commands that are internd to the shell, some of which 
have already been mentioned. The shell does not fork to execute these 
commands, so no additional processes are spawned. These commands should 
be used whenever possible, because they are, in general, faster and more 
efficient than other XENIX commands. The trade-off for this efficiency is that 
redirection of input and output is not allowed for most of these special 
commands. 
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Several of the special commands have already been described because they 
affect the flow of control. They are dot ( . ), break, continue, exit, and trap. 
The set command is abo a special command. Descriptions of the remaining 
special commands are given here: 

: The null command. This command does nothing and 

can be used to insert comments in shell procedures. 
Its exit status is zero (true). Its utility as a comment 
character has largely been supplanted by the number 
sign (#) which can be used to insert comments to the 
end-of-line. Beware: any arguments to the null 
command are parsed for syntactic correctness; when 
in doubt, quote such arguments. Parameter 
substitution takes place, just as in other commands. 



cd arg 



execarg. 



newgrp arg. 



read var... 



Make arg the current directory. If arg b not a valid 
directory, or the user is not authorized to access it, a 
nonzero exit status is returned. Specifying cd with 
no arg b equivalent to typmg "cdlHOME" which 
takes you to your home directory. 

If arg b a command, then the shell executes the 
command without forking and returning to the 
current shell. Thb effectively a "goto" and no new 
process is created. Input and output redirection 
arguments are allowed on the command line. If only 
input and output redirection arguments appear, 
then the input and output of the shell itself are 
modified according^. 

The newgrp command b executed, replacing the 
shell. Newgrp in turn creates a new shell. Beware: 
only environment variables will be known in the shell 
created by the newgrp command. Any variables 
that were exported will no longer be marked as such. 

One line (up to a newline) is read from the standard 
input and the first word is assigned to the first 
variable, the second word to the second variable, and 
so on. All words left over are assigned to the la$t 
variable. The exit status of read b zero unless an 
end-of-file b read. 



readonly «ar. 



times 



The specified variables are made readonly so that 
no subsequent assignments may be made to them. If 
no arguments are given, a list of all readonly and of 
all exported variables is given. 

The accumulated user and ^stem times for 
processes run from the current shell are printed. 
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umask nnn 



wait 



The user file creation m&sk is set to nun. If nnn b 
omitted, then the current value of the mask is 
printed. This bitrmask is used to set the default 
permissions when creating files. For example, an 
octal umask of 137 corresponds to the following bit- 
mask and permission settings for a newly created file: 



User 


user 


KTOUP 


other 


Octal 


1 


3 


7 


bit-mask 


001 


Oil 


111 


permissions 


rw- 


r— 


— 



See umatk(C) in the XES^^X Reference Manual for 
information on the value of nnn. 

The shell waits for all currently active child processes 
to terminate. The exit status of wait b always zero. 



7.11 Creation and Organization of Shell Procedures 

A shell procedure can be created in two simple steps. The first b building an 
ordinary text file. The second b changing the mode of the file to make it 
e2ecu(a6/e,thuspermittingittobeinvokedby 

proc args 

rather than 

sh proc args 

The second step may be omitted for a procedure to be used once or twice and 
then discarded, but is recommended for frequently-used ones. To set up a 
simple procedure, first create a file named mailall with the following contents: 

LETTER=$1 

shift 

for i in $* 

do mail $i <$LETTER 

done 

Next type: 

chmod +x mailall 

The new command might then be invoked from within the current directory by 
typing: 
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mail all letter joe bob 

Here letter is the name of the file containing the message you want to send, and 
j'oe and bob are people you want to send the message to. Note that shell 
procedures must always be at least readable, so that the shell itself can read 
commands from the file. 

If mailall were thus created in a directory whose name appears in the user's 
PATH variable, the user could change working directories and still invoke the 
maildl command. 

Shell procedures may be created dynamically. A procedure may generate a file 
of commands, invoke another instance of the shell to execute that file, and then 
remove it. An alternate approach is that of using the dot command (.) to make 
the current shell read commands from the new file, allowing use of existing shell 
variables and avoiding the spawning of an additional process for another shell. 

Many users prefer writing shell procedures to writing C programs. This is true 
for several reasons: 



1. Ashell procedure is easy to create and maintain because itisonly afile 
of ordinary text. 

2. A shell procedure has no corresponding object program that must be 
generated and maintained. 

3. A shell procedure is easy to create quickly, use a few times, and then 
remove. 

4. Because shell procedures are usually short in length, written in a 
high-level programming language, and kept only in their source- 
language form, they are generally easy to find, understand, and 
modify. 

By convention, directories that contain only commands and shell procedures 
are named bin. This name is derived from the word "binary", and is used 
because compiled and executable programs are often called "binaries" to 
distinguish them from program source files. Most groups of users sharing 
common interests have one or more 6tn directories set up to hold common 
procedures. Some users have their PATH variable list several such directories. 
Although you can have a number of such directories, it is unwise to go 
overboard: it may become difficult to keep track of your environment and 
efficiency may suffer. 



7.12 More About Execution Flags 

There are several execution flags available in the shell that can be useful in shell 
procedures: 
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-e This flag causes the shell to exit immediately if any command that it 
executes exits with a nonzero exit status. This flag is useful for shell 
procedures composed of simple command lines; it is not intended for 
use in conjunction with other conditional constructs. 

-u This flag causes unset variables to be considered errors when 
substituting variable values. This flag can be used to effect a global 
check on variables, rather than using conditional substitution to 
check each variable. 

-t This flag causes the shell to exit after reading and executing the 
commands on the remainder of the current input line. This flag is 
typically used by C programs which call the shell to execute a angle 
command. 

-n This is a "don't execute" flag. On occasion, one may want to check a 
procedure for syntax errors, but not execute the commands in the 
procedure. Using "set-nv" at the beginning of a file will accomplish 
this. 

-k This flag causes all arguments of the form variable 'rvalue to be 
treated as keyword parameters. When this flag is not set, only such 
arguments that appear before the command name are treated as 
keyword parameters. 



7.13 Supporting Commands and Features 

Shell procedures can make use of any XENIX command. The commands 
described in thb section are either used especially frequently in shell 
procedures, or are explicitly designed for such use. 



7.13.1 Conditional Evaluation: test 

The test command evaluates the expression specified by its arguments and, if 
the expression b true, test returns a zero exit status. Otherwise, a nonzero 
(false) exit status is returned. Test also returns a nonzero exit status if it has no 
arguments. Often it is convenient to use the test command as the first 
command in the command list following an if or a while. Shell variables used 
in test expressions should be enclosed in double quotation marks if there b any 
chance of their being null or not set. 

The square brackets may be used as an alias to test, so that 

[ txpre$$ion ] 

has the same effect as: 
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test cxpreation 

Note that the spaces before and after the expreation in brackets are essential. 

The following is a partial list of the options that can be used to construct a 
conditional expression: 

-r file True if the named file exists and b readable by the user. 

-w file True if the named file exists and is writable by the user. 

-X JUe True if the named file exists and is executable by the user. 

-s file True if the named file exbts and has a size greater than zero. 

-dfile True ifthe named file is a directory. 

-tfile True ifthe named file is an ordinary file. 

-2 9l True if the length of string $l\s zero. 

-n $1 True if the length of the string tl'is nonzero. 

-tfildea True if the open file whose file descriptor number is filde$ is 

associated with a terminal device. It filde$ la not specified, file 
descriptor 1 is used by default. 

$1 ss $2 True if strings $1 and f ^are identical. 

$1 !« $2 True if strings $1 and »^are not identical. 

tl True it el is not the null string. 

nl -eq nS True if the integers nl and nS are algebraically equal; other 
algebraic comparisons are indicated by -ne (not equal), —gt 
(greater than), -ge (greater than or equal to), -It (less than ), 
and -le (less than or equal to). 

These may be combined with the following operators: 

! Unary negation operator. 

-a Binary logical AND operator. 

-o Binary logical OR operator; it has lower precedence than the 

logical AND operator (-a). 

[expr) Parentheses for grouping; they must be escaped to remove 

their significance to the shell. In the absence of parentheses, 
evaluation proceeds from left to right. 

7-34 



The Shell 

Note that all options, operators, filenames, etc. are separate arguments to test. 

7.13.2 Ek;hoing Arguments 

The echo command has the following syntax: 

echo [ 0ption$ ] [ ar(f$ ] 

Echo copies its arguments to the standard output, each followed by a mngle 
space, except for the last argument, which is normally followed by a newline. 
Often, it b used to prompt the user for input, to issue diagnostics in shell 
procedures, or to add a few lines to an output stream in the middle of a pipeline. 
Another use is to verify the argument list generation process before issuing a 
command that does something drastic. The command 

b 

is often replaced by 

echo • 

because the latter is faster and prints fewer lines of output. 

The -n option to echo removes the newline from the end of the echoed line. 
Thus, the following two commands prompt for input and then allow typing on 
the same line as the prompt: 

echo -n enter name: ' 
read name 

The echo command also recognizes several escape sequences described in 
ecAo(C) in the XENIX Reference Manuel. 

7.13.3 Expression Evaluation: expr 

The expr command provides arithmetic and logical operations on integers and 
some pattern-matching facilities on its arguments. It evaluates a single 
expression and writes the result on the standard output; expr can be used 
inside grave accents to set a variable. Some typical examples follow: 

^ increment $A 

A"='expr $a + r 

# put third through last characters of 

# $1 into substring 
substrings ^expr "$1" : '..\(.*\) ' ' 
^ obtain length of $1 
c='expr "$r : '.* ' * 
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The most common uses of expr are in counting iterations of a loop and in using 
its pattern-matching capability to pick apartstrings. 



7.13.4 True and False 

The true and false commands perform the functions of exiting with 2ero and 
nonzero exit status, respectively. The true and false commands are often used 
to implement unconditional loops. For example, you might type: 

while true 

do echo forever 
done 

This will echo "forever" on the screen until an INTERRUPT is typed. 



7.13.5 In-Line Input Documents 

Upon seeing a command line of the form 

ecmmand << eofitring 

where eof$trxng is any arbitrary string, the shell will take the subsequent lines 
as the standard input of eommani until a line is read consisting only of 
eofttring. (By appending a minus (-) to the input redirection symbol (<<), 
leading spaces and tabs are deleted from each line of the input document before 
the shell passes the line to command.) 

The shell creates a temporary file containing the input document and performs 
variable and command substitution on its contents before passing it to the 
command. Pattern matching on filenames is performed on the arguments of 
command lines in command substitutions. In order to prohibit all 
substitutions, you may quote any character ot eofttring: 

command < < \eofstring 

The in-line input document feature is especially useful for small amounts of 
input data, where it is more convenient to place the data in the shell procedure 
than to keep it in aseparate file. For instance, you could type: 

cat < <- XX 

This message will be printed on the 
terminal with leading tabs and spaces 
removed. 

XX 

This in-line input document feature is most useful in shell procedures. Note 
that in-line input documents may not appear within grave accents. 
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7.13.6 Input/Output Redirection Using File Descriptors 

We mentioned above that a command occasionally directs output to some file 
associated with a file descriptor other than 1 or 2. In languages such as C, one 
can associate output with any file descriptor by using the v rite(S) ^stem call 
(see the XENIX Reference Manual. The shell provides its own mechanism for 
creating an output file associated with a particular file descriptor. By typing 

fdl>&fdg 

where fdl and /(f;? are valid file descriptors, one can direct output that would 
normally be associated with file descriptor fil to the file associated with fig. 
The default value for fdl and fdS is 1. If, at run time, no file is associated with 
fd8, then the redirection is void. The most common use of this mechanism is 
that of directing standard error output to the same file as standard output. 
This is accomplished by typing: 

commauid 2>&1 

If you wanted to redirect both standard output and standard error output to 
the same file, you would type: 

command l>file 2>&1 

The order here is significant: first, file descriptor 1 is associated with file; then 
file descriptor 2 is associated with the same file as is currently associated with 
file descriptor 1. If the order of the redirections were reversed, standard error 
output would go to the terminal, and standard output would go to file, because 
at the time of the error output redirection, file descriptor 1 still would have 
been associated with the terminal. 

This mechanism can also be generalized to the redirection of standard input. 
You could type 

fda<&fdb 

to cause both file descriptors fda and fdb to be associated with the same input 
file. If fda or fdb is not specified, file descriptor is assumed. Such input 
redirection is useful for a command that uses two or more input sources. 



7.13.7 Conditional Substitution 

Normally, the shell replaces occurrences of tvariable by the string value 
assigned to variable^ if any. However, there exists a special notation to allow 
conditional substitution, dependent upon whether the variable is set or not 
null. By definition, a variable is set if it has ever been assigned a value. The 
value of a variable can be the null string, which may be assigned to a variable in 
anyone of the following ways: 
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bed-"" 
efg= " 
set " "" 

The first three examples assign null to each of the corresponding shell variables. 
The last example sets the first and second positional parameters to null. The 
following conditional expressions depend upon whether a variable is set and not 
null. Note that the meaning of braces in these expressions differs from their 
meaning when used in grouping shell commands. Parameter as used below 
refers to either a digit or a variable name. 



${ V art able:- ttrtng} 



${ variable:>^atring} 



${ variable:^ $tring} 



If variable is set and b nonnull, then substitute the 
value tvariable in place of this expression. 
Otherwise, replace the expression with string. Note 
that the value of variable is not changed by the 
evaluation of this expression. 

If variable is set and is nonnull, then substitute the 
value tvariable in place of this expression. 
Otherwise, set variable to string, and then 
substitute the value tvariable in place of this 
expression. Positional parameters may not be 
assigned values in this fashion. 

If variable is set and is nonnull, then substitute the 
value of variable for the expression. Otherwise, 
print a message of the form 



${variable:+etring} 



variable: ttring 

and exit from the current shell. (If the shell is the 
login shell, it is not exited.) If string is omitted in 
this form, then the message 

variable: parameter null or not set 

is printed instead. 

If variable is set and is nonnull, then substitute 
string for this expression. Otherwise, substitute the 
null string. Note that the value of variable is not 
altered by the evaluation of this expresnon. 



These expressions may also be used without the colon. In this variation, the 
shell does not check whether the variable is null or not; it only checks whether 
the variable has ever been set. 

The two examples below illustrate the use of this facility: 
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1. This example performs an explicit assignment to the PATH variable: 

"PATH"-${PATH:- Vbin:/usr/bin '} 

This says, if PATH has ever been set and is not null, then keep its 
current value; otherwise, set it to the string *':/bin:/u8r/bin". 

2. This example automatically assigns the HOME variable a value: 

cd ${HOME:-» '/usr/gas '} 

If HOME is set, and is not null, then change directory to it. Otherwise 
set HOME to the given value and change directory to it. 

7.13.8 Invocation Flags 

There are four flags that may be specified on the command line when invoking 
the shell. These flags may not be turned on with the set command: 

-i If this flag is specified, or if the shell's input and output are both 
attached to a terminal, the shell is interactive. In such a shell, 
INTERRUPT (signal 2) is caught and ignored, and TERMINATE 
(signal 15) and QUIT (signal 3) are ignored. 

-s If thb flag is specified or if no input/output redirection arguments 
are given, the shell reads cbmmands from standard input. Shell 
output is written to file descriptor 2. The shell you get upon logging 
into the system has the -s flag turned on. 

-c When this flag b turned on, the shell reads commands from the first 
string following the flag. Remaining arguments are ignored. Double 
quotation marks should be used to enclose a multiword string, in 
order to allow for variable substitution. 

7.14 Effective and Efficient Shell Programming 

This section outlines strategies for writing efficient shell procedures, ones that 
do not waste resources in accomplishing their purposes. The primary reason 
for choosing a shell procedure to perform a specific function is to achieve a 
desired result at a minimum human cost. Emphasis should always be placed on 
simplicity, clarity, and readability, but efficiency can also be gained through 
awareness of a few design strategies. In many cases, an effective redesign of an 
existing procedure improves its efficiency by reducing its size, and often 
increases its comprehensibility. In any case, you should not worry about 
optimizing shell procedures unless they are intolerably slow or are known to 
consume an inordinate amount of a system's resources. 
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The same kind of iteration cycle should be applied to shell procedures as to 
other programs: write code, measure it, and optimize only the Jew important 
parts. The user should become familiar with the time command, which can be 
used to measure both entire procedures and parts thereof. Its use is strongly 
recommended; human intuition is notoriously unreliable when used to estimate 
timings of programs, even when the style of programming 'is a familiar one. 
Each timing test should be run several times, because the results are easily 
disturbed by variations in system load. 



7.14.1 Number of Processes Generated 

When large numbers of short commands are executed, the actual execution 
time of the commands may well be dominated by the overhead of creating 
processes. The procedures that incur significant amounts of such overhead are 
those that perform much looping and those that generate command sequences 
to be interpreted by another shell. 

If you are worried about elTiciency, it is important to know which commands 
are currently built into the shell, and which are not. Here b the alphabetical list 
of those that are built in: 



break 


case 


cd 


continue 


eval 


exec 


exit 


export 


for 


if 


newgrp 


read 


readonly 


set 


shift 


test 
wait 


times 
while 


trap 


umask 


until 
{} 



Parentheses, ( ), are built into the shell, but commands enclosed within them 
are executed as a child process, i.e., the shell does a fork, but no exec. Any 
command not in the above list requires both fork and exec. 

The user should always have at least a vague idea of the number of processes 
generated by a shell procedure. In the bulk of observed procedures, the number 
of processes created (not necessarily simultaneously) can be described by: 

processes ■« {k*n) + c 

where k and c are constants, and n may be the number of procedure arguments, 
the number of lines in some input file, the number of entries in some directory, 
or some other obvious quantity. Efficiency improvements are most commonly 
gained by reducing the value of k, sometimes to zero. 

Any procedure whose complexity measure includes n ' terms or higher powers 
of n is likely to be intolerably expensive. 

As an example, here is an analysis of a procedure named «p/tf, whose text is 
given below: 
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# split 

trap Vm tempfl; trap 0; exit '012315 

startl=0 start2<=0 

b-'[A-Za-z]' 

cat > temp$$ 

# read stdin into temp file 

# save original lengths of $1, $2 
if test -s "$r 

then startl»=Vc -1 < $r 

fi 

if test -s "$2" 

then start2= Vc -1 < $2' 

fi 

grep'Sb" temp$$ >> $1 

# lines with letters onto $1 
grep -V "$b" temp$$ | grep fO-S]' >> $2 

^ lines with only numbers onto $2 
totals" 'wc -1 < tempi!'" 
endl=''Vc-l < ir" 
end2=" wc -1 < $2'" 
lost='"expr Stotal - \($endl - $startl\) \ 
- \{$end2 - $start2\)^" 
echo "Stotal read, $lost thrown away" 

For each iteration of the loop, there is one expr plus either an echo or another 
expr. One additional echo is executed at the end. If n is the number of lines of 
input, the number of processes is2*n + 1. 

Some types of procedures should not be written using the shell. For example, if 
one or more processes are generated for each character in some file, it is a good 
indication that the procedure should be rewritten in C. Shell procedures should 
not be used to scan or build files a character at a time. 



7.14.2 Number of Data Bytes Accessed 

It is worthwhile considering any action that reduces the number of bytes read 
or written. This may be important for those procedures whose time is spent 
passing data around among a few processes, rather than in creating large 
numbers of short processes. Some filters shrink their output, others usually 
increase it. It always pays to put the $hrinkere first when the order b 
irrelevant. For instance, the second of the following examples is likely to be 
faster because the input to sort will be much smaller: 

sort file | grep pattern 
grep pattern file | sort 
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7.14.3 Shortening Directory Searches 

Directory searching can consume a great deal of time, especially in those 
applications that utilize deep directory structures and long pathnames. 
Judicious use of cd, the change directory command, can help shorten long 
pathnames and thus reduce the number of directory searches needed. As an 
exercise, try the following commands: 

Is -1 /usr/bin/* >/dev/null 
cd /usr/bin; lis -1 * >/dev/null 

The second command will run faster because of the fewer directory searches. 



7.14.4 Directory-Search Order and the PATH Variable 

The PATH variable is a convenient mechanism for allowing organization and 
sharing of procedures. However, it must be used in a sensible fashion, or the 
result may be a great increase in i^stem overhead. 

The process of finding a command involves reading every directory included in 
every pathname that precedes the needed pathname in the current PATH 
variable. As an example, consider the effect of invoking nroflf (i.e., 
/uer/btn/nroff) when the value of PATH b ":/bin:/usr/bm". The sequence of 
directories read is: 



/ 
/bin 

/ 

/usr 

/usr/bin 

This is a total of six directories. A long path list assigned to PATH can increase 
this number significantly. 

The vast majority of command executions are of commands found in /bin and, 
to a somewhat lesser extent, in /usr/bin. Careless PATH setup may lead to a 
great deal of unnecessary searching. The following four examples are ordered 
from worst to best with respect to the efHciency of command searches: 

:/usr/john/bin:/usr/localbin:/bin:/usr/bin 
:/bin:/usr/john/bin:/usr/localbin:/usr/bin 
:/bin:/usr/bin:/usr/john/bin:/usr/localbin 
/bin::/usr/bin:/usr/john/bin:/usr/localbin 

The first one above should be avoided. The others are acceptable and the 
choice among them is dictated by the rate of change in the set of commands 
kept in /bin and /uer/bin. 
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A procedure that is expensive because it invokes many short-lived commands 
may often be speeded up by setting the PATH variable inside the procedure so 
that the fewest possible directories are searched in an optimum order. 



7.14.5 Good Ways to Set Up Directories 

It is wise to avoid directories that are larger than necessary. You should be 
aware of several special sizes. A directory that contains entries for up to 30 files 
(plus the required . and ..) fits in a single disk block and can be searched very 
efficiently. One that has up to 286 entries is still a small directory; anything 
larger b usually a disaster when used as a working directory. It is especially 
important to keep login directories small, preferably one block at most. Note 
that, as a rule, directories never shrink. This is very important to understand, 
because if your directory ever exceeds either the 30 or 286 thresholds, searches 
will be inefficient; furthermore, even if you delete files so that the number of 
files is less than either threshold, the system will still continue to treat the 
directory inefficiently. 



7.15 Shell Procedure Examples 

The power of the XENIX shell command language is most readily seen by 
examining how XENIX'S many labor-saving utilities can be combined to 
perform powerful and useful commands with very little programming effort. 
This section gives examples of procedures that do just that. By studying these 
examples, you will gain insight into the techniques and shortcuts that can be 
used in programming shell procedures (also called "scripts"). Note the use of 
the number sign (#) to introduce comments into shell procedures. 

It is intended that the following steps be carried out for each procedure: 



1. Place the procedure in a file with the indicated name. 

2. Give the file execute permission with the chmod command. 

3. Move the file to a directory in which commands are kept, such asyour 
own bin directory. 

4. Make sure that the path of the bin directory is specified in the PATH 
variable found in .profile. 

5. Execute the named command. 
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Is /bin /usr/bin | sort | uniq -d 

This procedure determines which files are in both /bin and /utr/bin. It is done 
because files in /bin will "override" those in /u$r/bin during most searches and 
duplicates need to be weeded out. If the /uer/bin file is obsolete, then space b 
being wasted; if the /bin file is outdated by a corresponding entry in /it$r/bin 
then the wrong version is being run and, again, space is being wasted. This is 
also agood demonstration of "sort | uniq" to find matches and duplications. 

COPYPAIRS 



# Usage: copy pairs filel file2 ... 

# Copies filel to file2, file3 to file4, ... 
while test "$2" != "" 

do 

cp $1 $2 

shift; shift 
done 
if test" $r !="" 

then echo "$0: odd number of arguments" 
fi 

This procedure illustrates the use of a while loop to process a list of positional 
parameters that are somehow related to one another. Here a while loop is 
much better than a for loop, because you can adjust the positional parameters 
with the shift command to handle related arguments. 
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# Usage: copy to dir file ... 

^ Copies argument files to "dir", 

# maJcing sure that at least 

# two arguments exist, that "dir" is a directory, 
'^ and that each additional argument 

# is a readable file. 
if test |# -It 2 

then echo "$0: usage: copy to directory file ..." 
elif test ! -d $1 

then echo "$0: $1 b not a directory"; 
else dir«$l; shift 

for eachfile 

do cp Seachfile Idir 

done 
fi 

This procedure uses an if command with several parts to screen out improper 
usage. The for loop at the end of the procedure loops over all of the arguments 
to copy to but the first; the original $1 is shifted off. 



DISTINCTl 



# Usage: distinctl 

# Reads standard input and reports list of 

# alphanumeric strings that differ only in case, 

# giving lowercase form of each, 
tr -cs 'A-Za-zO-9 ' '\012 [jsort -u | \ 
tr 'A-Z ' 'a-z ' | sort | uniq -d 

This procedure is an example of the kind of process that is created by the left- 
to-right construction of a long pipeline. Note the use of the backslash at the end 
of the first line as the line continuation character. It may not be immediately 
obvious how this command works. You may wish to consult tr(C), $ort{C), and 
uniq{C) in the XENIX Reference Manual if you are completely unfamiliar with 
these commands. The tr command translates all characters except letters and 
digits into newline characters, and then squeezes out repeated newline 
characters. This leaves each string (in this case, any contiguous sequence of 
letters and digits) on a separate line. The sort command sorts the lines and 
emits only one line from any sequence of one or more repeated lines. The next 
tr converts everything to lowercase, so that identifiers differing only in case 
become identical. The output is sorted again to bring such duplicates together. 
The "uniq-d" prints (once) only those lines that occur more than once, yielding 
the desired list. 
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The process of building such a pipeline relies on the fact that pipes and files can 
usually be interchanged. The first line below is equivalent to the last two lines, 
assuming that sufiicient disk space is available: 

cmdl I cmd2 | cmdS 

cmdl > tempi; < tempi cmd2 > temp2; < temp2 cmd3 
rm temp(l23] 

Starting with a file of test data on the standard input and working from left to 
right, each command is executed taking its input from the previous file and 
putting its output in the next file. The final output is.then examined to make 
sure that it contains the expected result. The goal is to create a series of 
transformations that will convert the input to the desired output. 

Although pipelines can give a concise notation for complex processes, you 
should exercise some restraint, since such practice often yields 
incomprehensible code. 



DRAFT 



Usage: draft file(s) 

Print manual pages for Diablo printer, 
it* 



# 
# 
for i in $* 

do nroif -man Si | Ipr 
done 



Users often write this kind of procedure for convenience in dealing with 
commands that require the use of distinct fiags that cannot be given default 
values that are reasonable for all (or even most) users. 
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EDFIND 




# Usage: edfind file arg 

# Finds the last occurrence in "file" of a line 

# whose beginning matches "arg", then prints 

# 3 lines (the one before, the line itself, 
'^ and the one after) 

ed-$l <<-EOF 


EOF 


-+P 

q 



This illustrates the practice of using ed in-line input scripts into which the shell 
can substitute the values of variables. 



EDLAST 



# Usage: edlast file 

# Prints the last line of file, 

# then deletes that line. 
ed-$l <<-V 

Sp 

$d 

w 

q 
I 

echo done 

This procedure illustrates taking input from within the file itself up to the 
exclamation point ( ! ). Variable substitution is prohibited within the input text 
because of the backslash. 
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# Usage: fsplit filel file2 

# Reads standard input and divides it into 3 parts 

# by appending any line containing at least one letter 

# to filel, appending any line containing digits but 
^ no letters to file2, and by throwing the rest away. 
countasO goneaeO 

while read next 
do 

count—" "expr Icount + 1 *" 
case "$next" in 
•|A-Za-z]*) 

echo "Inext" >>$!;; 
•(0-91*) 

echo "Inext" >> $2;; 

•) 

gones»"*expr Igone + T" 

esac 
done 
echo "Icount lines read, Igone thrown away* 

Each iteration of the loop reads a line from the input and analyzes it. The loop 
terminates only when read encounters an end-of-file. Note the use of the expr 
command. 

Don't use the shell to read a line at a time unless you must — it can be an 
extremely slow process. 
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LISTFIELDS 

grep $• I tr ":" '•\012" 

This procedure lists lines containing any desired entry that is given to it as an 
argument. It places any field that begins with a colon on a newline. Thus, if 
given the following input 

joe newxnan: 13509 NE 78th St: Redmond, Wa 08062 

U$tfield$ will produce this: 

joe newman 
13500 NE 78th St 
Redmond, Wa 08062 

Note the use of the tr command to transpose colons to linefeeds. 
MKFILES 



# Usage: mkfiles pref (quantity] 

# Makes "quantity" files, named prefl, pref2, ... 

# Default is 5 as determined on following line. 
quantity»${2-5} 

i=l 

while test "li" -le "Iquantity" 

do 

>llli 

ii«" 'expr li+ T" 
done 

The mkfiltt procedure uses output redirection to create sero-length files. The 
expr command is used for counting iterations of the while loop. 
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NULL 



# Usage: null files 

^ Create each of the named files as an empty file. 

for each file 

do 

>$eachfile 
done 

This procedure uses the fact that output redirection creates the (empty) output 
file if a file does not already exist. 



PHONE 



# Usage: phone initials ... 

^ Prints the phone numbers of the 

# people -with the given initials, 
echo 'inits ext home ' 
grep"*!!" <<-END 

jfk 1234 999-2345 

Ibj 2234 583-2245 

hst 3342 98S-1010 

jqa 4567 555-1234 

END 

This procedure is an example of using an in-line input script to maintain a small 
database. 
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TEXTFILE 



if test "$r — "-s" 

then 

^ Return condition code 

shift 

if test -s " ^0 $*"" # check return value 

then 

exit 1 

else 

exitO 

fi 
fi 

if test |# -It 1 

then echo "|0: Usage: $0 ( -e ] file ..." 1>&2 

exitO 
fi 

file I* I fgrep ' text' | sed s/- •*//' 



To determine which files in a directory contain only textual information, 
teztfUe filters argument lists to other commands. For example, the following 
command line will print all the text files in the current directory: 

pr Hextfile •* | Ipr 

This procedure also uses an -s flag which silently tests whether any of the files 
in the argument list is a text file. 



WRITEMAIL 



# Usage: writemail message user 

# If user is logged in, 

# writes message to terminal; 

# otherwise,. mails it to user, 
echo "$r I { write "$2" i| mail "$2" ;} 

This procedure illustrates the use of command grouping. The message specified 
by $1 is piped to both the write command and, if write fails, to the mail 
command. 
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7.16 Shell Grammar 



item: 



iBori 

input- output 
name «> value 



iimple-eommand: item 

timple -command item 



command: 



pipeline: 



andor: 



command-list: 



file: 

c ate -part: 
pattern: 

el$e-part: 



simple -command 

( command-list ) 

{ command-list } 

for name do command-list done 

for name in wor^do command-list done 

while command-list do command-list done 

until command-list do command-list done 

case word in case-part esac 

if command-list then command-list else-part fl 

command 
pipeline | command 

pipeline 

andor &Sc pipeline 

andor || pipeline 

andor 

command-list ; 
command-list Sc 
command-list ; andor 
command-list & andor 



input- output: > file 
<file 



<< word 
>> word 



& digit 

&- 

pattern ) command-list ;; 

word 
pattern | word 

elif command-list then command-list else-part 
else command-list 
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empty 

empty: 

word: a $equenee of tionbUnk eharacter$ 

name: a $equenee ofletter$, iigit$, or unier$eore$ 

otarting with a Utter 

digit: 0123456780 
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Metacharacters and Reserved Words 



a. Syntactic 




1 


Pipe symbol 


&& 


And- if symbol 


II 


Or-if symbol 


J 


Command separator 


ft 


Case delimiter 


& 


Background commands 





Command grouping 


< 


Input redirection 


<< 


Input from a here document 


> 


Output creation 


< 


Output append - 


# 


Comment to end of line 



b. Patterns 

* Match any character (s) including none 

? Match any single character 

[...] Match any of enclosed characters 

c. Substitution 

${...} Substitute shell variable 

\./ Substitute command output 
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Quoting 

\ Quote next character as literal with no special meaning 

'...' Quote enclosed characters excepting the back quotation 

marks ( ') 

"..." Quote enclosed char actersex cepting: $ *\" 



Reserved words 




if 


esac 


then 


for 


else 


while 


elif 


until 


fi 


do 


case 


done 


in 


{ } 
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8.1 Introduction 



BC is a program that can be used as an arbitrary precision arithmetic 
calculator. BC's output is interpreted and executed by a collection of routines 
which can input, output, and do arithmetic on indefinitely large integers and on 
scaled fixed-point numbers. Although you can write substantial programs with 
BC, it is often used as an interactive tool for performing calculator-like 
computations. The language supports a complete set of control structures and 
functions that can be defined and saved for later execution. The ^ntax of BC 
has been deliberately selected to agree with the G language; those who are 
familiar with C will find few surprises. A small collection of library functions is 
also available, including sin, cos, arctan, log, exponential, and Bessel functions 
of integer order. 

Common uses for BC are: 

— Computation with large integers. 

— Computations accurate to many decimal places. 

— Conversions of numbers from one base to another base. 

There is a scaling provision that permits the use of decimal point notation. 
Provision is made for input and output in bases other than decimal. Numbers 
can be converted from decimal to octal simply by setting the output base equal 
to 8. 

The actual limit on the number of digits that can be handled depends on the 
amount of storage available on the machine, so manipulation of numbers with 
many hundreds of digits is possible. 

8.2 Demonstration 

This demonstration is designed to show you: 

— Ho w to get in to and out of BC. 

— How to perform simple computations. 

— How expressions are formed and evaluated. 

— How to assign values to registers. 

A normal session with BC begins by invoking the program with the command: 

be 
To exit BC type 
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quit 



or press CNTRL-D. Once you have entered BC, you can use it very much like a 
normal calculator. As with the XENIX shell, commands are read as command- 
lines, so each line that you type must be terminated by a RETURN. Throughout 
this chapter, the RETURN is implied at the end of each command line. Within 
BC, normal processing of other keys, such as BKSP and INTERRUPT, also 
works. 

For example, type the simple integer 5: 

5 

Output is immediately echoed on the next line to the standard output, which is 
normally the terminal screen: 

5 

Here "5" is a simple numeric expression. However, if you type the expression 

5*5.25 

(where the star (*) is the multiplication operator) a computation is executed 
and the result printed on the next line: 

26.25 

What has happened here is that the line "5*5.25" has been evaluated, i.e., the 
expression has been reduced to its most elementary form, which is the number 
26.25. The process of evaluation normally involves some type of computation 
such as multiplication, division, addition, or subtraction. For example, all four 
of these operations are involved in the following expression: 

(10*5)+50-(50/2) 

When this expression is evaluated, the subexpressions within parentheses are 
evaluated first, just as they would be with simple algebra, so that an 
intermediate step in the evaluation is "50-1-50-25" which ultimately reduces to 
the number "75". 

The simple addition 

10.45-I-5.5555555 
produces the output: 

16.0055555 
Note how precision is retained in the above result. 
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The two-part multiplication 

(8*9)*7 
produces the answer: 

504 

The last part of this demonstration shows you how to store values in special 
alphabetic regbters. For example, type: 

a=100 ; b=5 

What happens here is that the registers "a" and "b" are assigned the values 100 
and 5, respectively. The semicolon is used here to place multiple BC statements 
on a single line, just as it is used in the XENIX shell. This command line 
produces no output because assignment statements are not considered 
expressions. However, the registers "a" and "b" can now be used in 
expressions. Thus you can now type 

a«b; a+b 

to produce: 

500 
105 

To exit BC, remember to type 

quit 

or press CNTRL-D. 

This ends the demonstration. Following sections describe use of BC in more 
detail. The final section of this chapter is aBC language reference. 

8.3 Tasks 

This section describes how to perform common BC tasks. Mastery of these 
tasks should turn you into a competent BC user. 



8.3.1 Computing with Integers 

The simplest kind of statement is an arithmetic expression on a line by itself. 
For instance, if you type 

142857 + 285714 
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and press RETURN, BC responds immediately with the line: 

428571 
Other operators also can be used. The complete list includes: 

+ -•/%* 

They indicate addition, subtraction, multiplication, division, modulo 
(remaindering), and exponentiation, respectively. Division of integers 
produces an integer result truncated toward zero. Division by zero produces an 
error message. 

Any term in an expression can be prefixed with a minus sign to indicate that it is 
to be negated (this is the "unary" minus sign). For example, the expression 

7+-3 

is interpreted to mean that -3 is to be added to 7. 

More complex expressions with several operators and with parentheses are 
interpreted just as in FORTRAN, with exponentiation (*) performed first, 
then multiplication (*), division (/), modulo (%), and finally, addition (+), and 
subtraction (-). The contents of parentheses are evaluated before expres^ons 
outside the parentheses. All of the above operations are performed from left to 
right, except exponentiation, which is performed from right to left. Thus the 
following two expressions 

a*b*c and a*(b*c) 

are equivalent, as are the two expressions: 

a*b*c and (a*b)*c 

BC shares with FORTRAN and C the convention that a/b*c is equivalent to 
(a/b)*c. 

Internal storage registers to hold numbers have single lowercase letter names. 
The value of an expression can be assigned to a register in the usual way, thus 
the statement 

X «x + 3 

has the efiect of increasing by 3 the value of the contents of the register named 
"x". When, as in this case, the outermost operator is the assignment operator 
(s=), then the assignment is performed but the result is not printed. There are 
26 available named storage registers, one for each letter of the alphabet. 

There is also a built-in square root function whose result is truncated to an 
integer (See also Section 8.5, "Scaling"). For example, the lines 
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X i« 8qrt(ldl) 

X 

produce the printed result 
13 



8.3.2 Specifying Input and Output Bases 

There are special internal quantities in BC, called iba$e and oba$e. Ibate is 
initially set to 10, and determines the base used for interpreting numbers that 
are read by BC. For example, the lines 

ibase '^ 8 
11 

produce the output line 

9 

and you are all set up to do octal to decimal conversions. However, beware of 
trying to change the input base back to decimal by typing: 

ibase ■» 10 

Because the number 10 is interpreted as' octal, this statement has noeffect. For 
those who deal in hexadecimal notation, the characters A-F are permitted in 
numbers (no matter what base is in effect) and are interpreted as digits having 
values 10-15, respectively. These characters mu$t be uppercase and not 
lowercase. The statement 

ibase >s A 

changes you back to decimal input base no matter what the current input base 
is. Negative and large positive input bases are permitted; however no 
mechanism has been provided for the input of arbitrary numbers in bases less 
than 1 and greater than 16. 

Oba$e is used as the base for output numbers. The value of 0ba$e is initially set 
to a decimal 10. The lines 

obase = 16 
1000 

produce the output line: 

3E8 
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This is interpreted as a three-digit hexadecimal number. Very large output 
bases are permitted. For example, large numbers can be output in groups of 
five digits by setting oba0e to 100000. Even strange output bases, such as 
negative bases, and 1 and 0, are handled correctly. 

Very large numbers are split across lines with seventy characters per line. A 
split line that continues on the next line ends with a backslash (\). Decimal 
output conversion is fast, but output of very large numbers (i.e., more than 100 
digits) with other bases is rather slow. 

Remember that iba$e and oba$e do not affect the course of internal 
computation or the evaluation of expressions; they only affect input and output 
conversion. 



8.3.3 Scaling Quantities 

A special internal quantity called $eale is used to determine the scale of 
calculated quantities. Numbers can have up to SO decimal digits after the 
decimal point. This fractional part is retained in further computations. We 
refer to the number of digits after the decimal point of a number as its scale. 

When two scaled numbers are combined by means of one of the arithmetic 
operations, the result has ascale determined by the following rules: 

Addition, subtraction 

The scale of the result is the larger of the scales of the two 
operands. There is never any truncation of the result. 

Multiplication The scale of the result is never less than the maximum of the 
two scales of the operands, never more than the sum of the 
scales of the operands, and subject to those two restrictions, 
the scale of the result is set equal to the contents of the 
internal quantity, $cde. 

Division The scale of a quotient is the contents of the internal 

quantity, 9ca/e. 

Modulo The scale of a remainder b the sum of the scales of the 

quotient and the divisor. 

Exponentiation The result of an exponentiation is scaled as if the implied 
multiplications were performed. An exponent must be an 
integer. 

Square Root The scale of a square root is set to the maximum of the scale 

of the argument and the contents of $€ de. 

All of the internal operations are actually carried out in terms of integers, with 
digits being discarded when necessary. In every case where digits are dbcarded 
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truncation is performed without rounding. 

The contents of teale must be no greater than 89 and no less than 0. It b initially 
set to 0. 

The internal quantities «ca/e, ibaie, and ba$e can be used in expressions just 
like other variables. The line 

scale as scale + 1 
increases the value of $eale by one, and the line 

scale 

causes the current value of $e<Ue to be printed. 

The value of $eale retains its meaning as a number of decimal digits to be 
retained in internal computation even when ibase or obaee are not equal to 10. 
The internal computations (which are still conducted in decimal, regardless of 
the bases) are performed to the specified number of decimal digits, never 
hexadecimal or octal or any other kind of digits. 

8.3.4 Using Functions 

The name of a function is a single lowercase letter. Function names are 
permitted to use the same letters as simple variable names. Twenty-six 
different defined functions are permitted in addition to the twenty-six variable 
names. The line 

define a(x){ 

begins the definition of a function with one argument. This line must be 
followed by one or more statements, which make up the body of the function, 
ending with a right brace ( } ). Return of control from a function occurs when a 
return statement is executed or when the end of the function is reached. The 
return statement can take either of the two forms: 

return 
return(x) 

In the first case, the returned value of the function is 0; in the second, it is the 
value of the expression in parentheses. 

Variables used in functions can be declared as automatic by a statement of the 
form 

auto x,y,z 

There can be only one auto statement in a function and it must be the first 
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statement in the definition. These automatic variables are allocated space and 
initialized to zero on entry to the function and thrown away on return. The 
values of any variables with the same names outside the function are not 
disturbed. Functions can be called recursively and the automatic variables at 
each call level are protected. The parameters named in a function definition are 
treated in the same way as the automatic variables of that function, with the 
single exception that they are given a value on entry to the function. An 
example of a function definition follows: 

define a(x,y){ 
auto z 
z =s x*y 

return(z) 
} 

The value of this function, when called, will be the product of its two 
arguments. 

A function is called by the appearance of its name, followed by a string of 
arguments enclosed in parentheses and separated by commas. The result is 
unpredictable if the wrong number of arguments is used. 

If the function "a" is defined as shown above, then the line 

a(7,3.14) 
would print the result: 

21.98 
Similarly, the line 

X - a{a(3,4).5) 

would cause the value of "x" to become 60. 

Functions can require no arguments, but still perform some useful operation or 
return a useful result. Such functions are defined and called using parentheses 
with nothing between them. For example: 

M) 

calls the function named 6. 

8.3.5 Using Subscripted Variables 

A single lowercase letter variable name followed by an expression in brackets is 
called a subscripted variable and indicates an array element. The variable 
name b the name of the array and the expression in brackets is called the 
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subscript. Only one-dimensional arr&ys are permitted in BC. The names of 
arrays are permitted to collide with the names of simple variables and function 
names. Any fractional part of a subscript is discarded before use. Subscripts 
must be greater than or equal to zero and less than or equal to 2047. 

Subscripted variables can be freely used in expressions, in function calls and in 
return statements. 

An array name can be used as an argument to a function, as in: 

f(»l 1) 

Array names can also be declared as automatic in a function definition with the 
use of empty brackets: 

define f(a{ ]) 
auto a| ] 

When an array name is so used, the entire contents of the array are copied for 
the use of the function, then thrown away on exit from the function. Array 
names that refer to whole arrays cannot be used in any other context. 

8.3.6 Using Control Statements: if, while and for 

The if, while, and for statements are used to alter the flow within programs or 
to cause iteration. The range of each of these statements b a following 
statement or compound statement consisting of a collection of statements 
enclosed in braces. They are written as follows: 

it (relation) ttatement 

while ( rtlation) itatement 

toT(eipreB$ionl\ relation; expre$$ionSj$tatement 

if ( relation) { $tatement$} 

while ( relation) { $tatement$ } 

tor{eipre$$ionl; relation; expre$$ionS) {ttatementi} 

A relation in one of the control statements is an expression of the form 

expre$tionl rel-op txpre$$ion2 
where the two expressions are related by one of the six relational operators: 

<><=>= == != 

Note that a double equal sign (=") stands for "equal to" and an exclamation- 
equal sign (!=) stands for "not equal to". The meaning of the remaining 
relational operators is their normal arithmetic and logical meaning. 
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Beware of using a single equal sign (>■) instead of the double equal sign (<«■>■) in 
a relational. Both of these symbols are legal, so you will not get a diagnostic 
message. However, the operation will not perform the intended comparison. 

The if statement causes execution of its range if and only if the relation is true. 
Then control passes to the next statement in the sequence. 

The while statement causes repeated execution of its range as long as the 
relation is true. The relation is tested before each execution of its range and if 
the relation is false, control passes to the next statement beyond the range of 
the while statement. 

The for statement begins by executing cxprtt$ionl. Then the relation is tested 
and, if true, the statements in the range of the for statement are executed. 
Then txprtteion2\s executed. The relation is tested, and so on. The typical use 
of the for statement is for a controlled iteration, as in the statement 

for(i— 1; i<«»10; ix»i+l) i 

which will print the integers from I to 10. 

The following are some examples of the use of the control statements: 

define f(n){ 

auto i, X 

x-1 

for(ia>l; i<«n; i—i+l) x-»x*i 

return(x) 

} 

The line 

f(a) 

prints "a" factorial if "a" is a positive integer. 

The following is the definition of a function that computes values of the 
binomial coefficient ( "m" and "n" are assumed to be positive integers): 

define b(n,m){ 

auto X, j 



} 



X— 1 

for(j-l; j<«m; j-=j+l) x=x«(n-j+l)/j 
return(x) 
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The following function computes values of the exponential function by 
summing the appropriate series without regard to possible truncation errors: 



scale ■ 


-20 




define 


e(x){ 






auto a, 


b, c, d, n 




a« 1 






b-1 






c— 1 






d-0 






n- 1 






while(l> 


a-» a*x 

b ■» b*n 
c — c + a/b 
n — n + 1 
if(cmd) return(c) 
d-c 
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8.3.7 Using Other Language Features 

Some language features that every user should know about are listed below. 

— Normally, statements are typed one to a line. It is also permissible to 
type several statements on a line if they are separated by semicolons. 

— If an assignment statement is placed in parentheses, it then has a 
value and can be used anywhere that an expression can. For example, 
the line 

{x-y+17) 

not only makes the indicated assignment, but also prints the resulting 
value. 

The following is an example of a use of the value of an assignment 
statement even when it is not placed in parentheses: 

X mm a[i«»i+lj 

This causes a value to be assigned to "x" and also increments "i'* 
before it is used as a subscript. 

— The following constructions work in BC in exactly the same manner 
as they do in the C language: 



Construction 


Equivalent 


x==y=z 


X «(y=z) 


X =«+ y 


X » x+y 


X =»-y 


X ■« x-y 


X ««*y 


X — x*v 


x-/y 


X — x/y 


x=%y 


X «»x%y 


X —* y 


X ■■ x*y 


X+ + 


(x— x+l)-l 


X — 


(x-x-l)+l 


++X 


X ««x+l 


X 


X "» x-1 



Even if you don't intend to use these constructions, if you type one 
inadvertently, something legal but unexpected may happen. Be 
aware that in some of these constructions spaces are significant. 
There is a real difference between "x*"-y" and "x»« -y". The first 
replaces "x" by "x-y" and the second by "-y". 
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The comment convention is identic&l to the C comment convention. 
Comments begin with "/*" »nd end with "•/". 

There is a library of math functions that can be obtained by typing 

bc-1 

when you invoke BC. This command loads the library functions sine, 
cosine, arctangent, natural logarithm, exponential, and Bessel 
functions of integer order. These are named "s", "c", "a", "1", "e", 
and "j(n,x)", respectively. Thb library sets «ea/e to 20 by default. 

If you type 

be file ... 

BC will read and execute the named file or files before accepting 
commands from the keyboard. In this way, you can load your own 
programs and function definitions. 
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8.4 Language Reference 

This section is a comprehensive reference to the BC language. It contains a 
more concise description of the features mentioned in earlier sections. 



8.4.1 Tokens 

Tokens are keywords, identifiers, constants, operators, and separators. Token 
separators can be blanks, tabs or comments. Newline characters or semicolons 
separate statements. 

Comments Comments are introduced by the characters "/*" &nd are 

terminated by "*/"• 

Identifiers There are three kinds of identifiers: ordinary identifiers, 

array identifiers and function identifiers. All three types 
consist of single lowercase letters. Array identifiers are 
followed by square brackets, enclosing an optional expression 
describing a subscript. Arrays are singly dimensioned and 
can contain up to 2048 elements. Indexing be^pns at so an 
array can be indexed from to 2047. Subscripts are 
truncated to integers. Function identifiers are followed by 
parentheses, enclosing optional arguments. The three types 
of identifiers do not conflict; a program can have a variable 
named "x", an array named "x", and a function named "x", 
all of which are separate and dbtinct. 

Keywords The following are reserved keywords: 



ibase 


if 


obase 


break 


scale 


define 


sqrt 


auto 


length 


return 


while 


quit 


for 





Constants Constants are arbitrarily long numbers with an optional 

decimal point. The hexadecimal digits A-F are also 
recognized as digits with decimal values 10-15, respectively. 



8.4.2 Expressions 

All expressions can be evaluated to a value. The value of an expression is always 
printed unless the main operator b an assignment. The precedence of 
expressions (i.e., the order in which they are evaluated) b as follows: 
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Function calls 

Unary operators 

Multiplicative operators 

Additive operators 

Assignment operators 

Relational operators 
There are several types of expressions: 

Named expressions 

Named expressions are places where v&lues are stored. Simply stated, 
named expressions are legal on the left side of an assignment. The value 
of a named expression is the value stored in the place named. 

ident{fier$ 

Simple identifiers are named expressions. They have an initial 
value of zero. 

array-name[expre$Bion] 

Array elements are named expressions. They have an initial value 
of zero. 

teale, iba$c andoba$e 

The internal registers $cale, iba$e, and oba$e are all named 
expressions. Scale is the number of digits after the decimal point to 
be retained in arithmetic operations and has an initial value of zero. 
Ibaae and obaee are the input and output number radixes 
respectively. Both iba$e and oba$e have initial values of 10. 

Constants 

Constants are primitive expressions that evaluate to themselves. 

Parenthetic Expressions 

An expression surrounded by parentheses is a primitive expression. The 
parentheses are used to alter normal operator precedence. 

Function Calb 

Function calls are expressions that return values. They are discussed in 
section 8. 10.3. 

8.4.3 Function Calls 

A function call consists of a function name followed by parentheses containing a 
comma-separated list of expressions, which are the function arguments. The 
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syntax is as follows: 

function- name ( [expreanon [ , expre$»ion ...]]) 

A whole array passed as an argument is specified by the array name followed by 
empty square brackets. All function arguments are passed by value. As a 
result, changes made to the formal parameters have no effect on the actual 
arguments. If the function terminates by executing a return statement, the 
value of the function is the value of the expression in the parentheses of the 
return statement, or if no expression is provided or if there is no return 
statement. Three built-in functions are listed below: 

8qrt(expr} The result is the square root of the expression and is 

truncated in the least significant decimal place. The scale of 
the result b the scale of the expression or the value of $ede , 
whichever b larger. 

length( expr) The result is the total number of significant decimal digits in 
the expression. The scale of the result b zero. 

scale ( expr) The result is the scale of the expression. The scale of the 
result is zero. 

8.4.4 Unary Operators 

The unary operators bind right to left. ■ 

-etpr The result b the negative of the expressnon. 

-h't-named_expr The named expression b incremented by one. The result b 
the value of the named expression after incrementing. 

— namcijtxpr The named expression is decremented by one. The result b 
the value of the named expression after decrementing. 

namti_jtxpr++ The named expression b incremented by one. The result b 
the value of the named expression before incrementing. 

namtdjtxpr— The named expression is decremented by one. The result b 
the value of the named expression before decrementing. 

8.4.5 Multiplicative Operators 

The multiplicative operators (*, /, and %) bind from left to right. 

expr*txpr The result b the product of the two expresnons. If "a" and 

"b" are the scales of the two expresaons, then the scale of the 
result is: 



8-16 



BC: A Calculator 



min ( a+b, max ( scale, a, b ) ) 

expr/ctpr The result is the quotient of the two expressions. The scale of 

the result is the value of tcdt. 

expr%expr The modulo operator (%) produces the remainder of the 

divbion of the two expressions. More precisely, «%& u 
&-a/b*b. The scale of the result is the stmi of the scale of the 
divisor and the value of $eale . 

espr^ expr The exponentiation operator binds right to left. The result is 

the first expression raised to the power of the second 
expression. The second expression must be an integer. If "a" 
b the scale of the left expression and ''b" b the absolute value 
of the right expression, then the scale of the result b: 

min ( a*b, max ( scale, a ) ) 



8.4.6 Additive Operators 

The additive operators bind left to right. 

etpr+txpr The result is the sum of the two expressions. The scale of the 

result is the maximum of the scales of the expressions. 

txpr-cxpr The result b the difi'ei'ence of the two expressions. The scale 

of the result b the maximum of the scales of the expressions. 

8.4.7 Assignment Operators 

The assignment operators listed below assign values to the named expression 
on the left side. 

namtd^expr'^txpr 

This expression results in assigning the value of the expression on 
the right to the named expression on the left. 

tt ame <(_< *pr»r +c«pr 

The result of this expression is equivalent to 
namt djexpr*^namedjcxpr-texpr. 

n ame d_e xpfae-txpr 

The result of this expression is equivalent to 
name d_jexpr'=natned__cxpr-cxpr. 

name rf_c«pra=» *expr 

The result of this expression is equivalent to 
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named^expr'»named_expr*etpr. 

name i^e xpraacj espr 

The result of this expression is equivalent to 
ntmti_txprsasnameijtxpr/ expr. 

namei^expr'^%expr 

The result of this expression is equivalent to 
namti_txpr'B'namei_txpr%txpr. 

namtd_exprBs'^ txpr 

The result of this expression is equivalent to 
namei^txpr'^nameijtxpr'' cxpr. 



8.4.8 Relational Operators 

Unlike all other operators, the relational operators are only valid as the object 
of an if or while statement, or inside a for statement. These operators are 
listed below: 

expr<expT 

expr>expr 

expr< sstxpr 

expr> f^txpr 

exprsBSBsexpr 

exprfsBcxpr 



8.4.Q Storage Classes 

There are only two storage classes in BC: global and automatic (local). Only 
identifiers that are to be local to a function need to be declared with the auto 
command. The arguments to a function are local to the function. All other 
identifiers are assumed to be global and available to all functions. 

All identifiers, global and local, have initial values of zero. Identifiers declared 
as auto are allocated on entry to the function and released on rettvning from 
the function. They, therefore, do not retain values between function calls. 
Note that auto arrays are specified by the array namer, followed by empty 
square brackets. 

Automatic variables in BC do not work the same way as in C. On entry to a 
function, the old values of the names that appear as parameters and as 
automatic variables are pushed onto a stack. Until return is made from the 
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function, reference to these names refers only to the new values. 

8.4.10 Statements 

Statements must be separated by a semicolon or a newline. Except where 
altered by control statements, execution is sequential. There are four types of 
statements: expression statements, compound statements, quoted string 
statements, and built-in statements. Each kind of statement is dbcussed 
below: 

Expression statements 

When a statement is an expression, unless the main operator 
b an assignment, the value of the expression b printed, 
followed by a newline character. 

Compound statements 

Statements can be grouped together and used when one 
statement b expected by surrounding them with curly braces 
({and}). 

Quoted string statements 
For example 

" Btrtrtif 

prints the string inside the quotation marks. 

Built-in statements 

Built-in statements include auto, break, define, for, if, 
quit, return, and while. 

The ^ntax for each built-in statement is given below: 

Auto statement 

The auto statement causes the values of the identifiers to be 
pushed down. The identifiers can be ordinary identifiers or 
array identifiers. Array identifiers are specified by following 
the array name by empty square brackets. The auto 
statement must be the first statement in a function definition. 
Syntax of the auto statement b: 

auto identifier [, identifier] 

Break statement 

The break statement causes termination of a for or while 
statement. Syntax for the break statement is: 
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break 

Define statement 

The define statement defines a function; parameters to the 
function can be ordinary identifiers or array names. Array 
names must be followed by empty square brackets. The 
syntax of the define statement is: 

define ffparameter f , parameter ...]J){»taiemeni»} 

For statement 

The for statement is the same as: 

firtt'expre$$ion 
whi\e{relation) { 

$tatement 

last'expreBncn 
} 

All three expressions must be present. Syntax of the for 
statement is: 

for (expre$$ion; relation;expre$$i«n) $tatement 

Ifstatement - 

The statement b executed if the relation is true. The syntax 
is as follows: 

if (relation) etatetnent 

Quit statement 

The quit statement stops execution of a BC program and 
returns control to XENIX when it b first encountered. 
Because it is not treated as an executable statement, it cannot 
be used in a function definition or in an if, for, or while 
statement. Note that entering a CNTRL-D at the keyboard b 
the same as typing "quit". The syntax of the quit statement 
b as follows: 

quit 

Return statement 

The return statement terminates a function, pops its auto 
variables off the stack, and specifies the result of the function. 
The result of the function b the result of the expression in 
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parentheses. The first form is equivalent to "return(O)". The 
syntax of the return statement is as follows: 

return(expr) 

While statement 

The statement is executed while the relation is true. The test 
occurs before each execution of the statement. The syntax of 
the while statement is as follows: 

v)hUe (relation) $tatement 
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BuOding a Uuqi System 

9.1 Introduction 

The uucp system is a scries of programs designed to petmit communication between 
X£N1X systems using dial— up communication lines. Uucp provides file transfer and 
remote command execution through a l>atch— type operation. Files arc created in a 
spooldirectoiyforpcocessingbydieuucpdaemous. Ilieic are three types of fiksuscd 
fortheexecutionofwoik: 

Datafiles Containdatafortiansfertoicmotesystcms 

Work files Containdiiectioiis for file traosfersbetweeo systems 

Execution files Coitain direaions for XENIX coomiand executions w^icfa 

involve the resouicesofooe or more systems. 

The uucp system consists of four primary and two secondary programs. The primary 
programs are: 

uucp Husprogramcreateswofkandgatbersdatafilesintfaespooldirectoryfor 

tbe transmission of files. 

uux Hiisprogramcreateswoikfiles.exocutefilesandgathendatafilesforthe 

remote executionofXENIX coimnands. 

imcico Thisprogramexeoilestheworikfilesfordatatranamission. 

uuxqt This p ro g r am executes the execution files for XENIX command 

execution. 

The secondary programs are: 

uulog This program updates die log file with new entries and reports on the 

status of uucprequests. 

uuclean ThisprogramremovesoU01esfiomtheqxx>ldirectory. 

This chaptCT describes the operation of each program, the installation of the system, 
the security aspects of the syston, the files required for execution, and the 
administration of the system. 

For hardwired communications between XENIX systems, use the Micnet network 
described in the XENIXO/vra/io/uGiMt/ff. 

9.2 Uucp - System to System File Copy 

The uucp program is the user's primary interface with the system. The uucp program 
wasdesignedtolodclikethecpcommand. Iliesyntaxis 

uucp [ option ] ... source ... destination 

where source and destination may contain the prefix system— name! whidi indicates 
the system on whidi the fileor filesreside or where they will be copied. 
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Theoptions interpreted t^ttticp are: 

~d Makedirectorieswhcnnccessaiyforcopyingthefik. 

-c OonHcopysounrefikstotheqxwldiiectofy.butusethespecifiedsouice 

wfaentbe actual transfertakesplace. 

--fitter Put ilemrinasthe grade in the name ofthewoifc file. (This can be used to 
diangetheoFderofwoifcforapanicularnucfaiiie.) 

-m Seodmailoncompletkmofthewak. 

The following options aieusedprtnurilyfordebugsing: 

-r QueuethejobbutdonocAartiofdcoprognun. 

~%dir Usedirectocy^iirfortfaeqwoldirectoiy. 

"xmm Uaeiwmasthelevelofddwggingoutput. 

The destinatitmmiybeadifectocyname.in which case the fifc name is tdEcn from die 
last part of the source's oanoe. The source name may costain special shcD character* 
such as **?^". lfaaouiceaigunieitthasa5yxfein-iKinie/pre&xforaiemoteifystem. 
the file nameexpanskm will bedoneootheremotesystem. 

Thecommand 

uucp *.c usg!AM/dan 

win setupthetnmsfaof aU fiks whosenaiqesend widi .ctothe^urMmdirBctafy on 
theiu^madtine. 

Thescurceand/ordestinatioananiesmayalsocomaina user prefix. This translates 
to the login directory on the specified system. For names with partial pathnames, the 
cunent dircctoiy is piepeaded to the fife name. File names w^ **.S* are not 
permitted. 

Thecommand 

uucp usg!dan/*.h dan 

will set up the transfer of files whose names end with .A in dan's login diiectocy <m 
system ujf to dan'slocal login duectory. 

For each source file, the program will check the source and destination fifenames and 
the system-panofeachtoclassify the work into one of five types: 

1. Copy source to deslinationon local system. 

2. Reodvefiles&omodKTsystems. 

3. Sendfifestoaremotesystcms. 

4. Sendfiksfinmremotesystemstoanodierremoteiystem. 

5. Receive fifes fiom remote systems vlien the source contains special shdl 
charactersasmentioned above. 



9-2 



Building a iiucp System 

After the work hasbccn set up in the spool diicctofy, the i<fic7C<> program is staited to try 
to conuct the other madiinetocxecute the woii(unlcssthe-roption was specified). 

9.2. 1 Copying FBo to a Local Dcstinatioa 

Aqi command is used to do type 1 wock. The -d and the -moptionsare nothooored 
inthiscase. 

9.2.2 Receiving FOcs from Other Systons 

For type 2 worlc. a one line work file is created for eadi file requested and put in the 
spool directory with the following fields, eadi separated by a blank. 

fll R 

[2] The full pathname ofthc source or a user/pathname. Ibe user pact 

will beexpanded on theremote system. 

[3] The full pathname ofthc destination file, if the ii5erix>tationisused,it 

will be immediately eayandedtobe the togindiitctoiyforthe user. 

|4] Theuser's login name. 

\5] A "~ " followed by an option list. (Only the — a and -d options will 

appear in thislist.) 

9.2J Sending FBes to Remote Syttems 

For type 3 work, a woik file is created for each dsource file and the source file is copied 
into a data file in the spool directory. (A— c option 00 the uurpfvogram will prevent 
the dau file from being made. In this case, the file will be transmitted from the 
indicated source.)Thefieldsof eadi entry are givenbelow. 

fll s 

[2] Thefiillpathnameofthe source file. 

[3] ThefuUpathnameofthedestinationor user/filename. 

[4] Theuser'sloginname. 

fs] A**-"foIlowedbyanoptionlisi. 

[6] Thenameofthedatafileinthespooldircctory. 

[7] Thefilemodebitsofthe sourcefileinoculprintfofmat(e.g. 0666). 
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9.2.4 Copying Flcs Between Systems 

For ty])e 4 and S woik, uucp generates a uucp command line and sends it to the remote 
machine; the rentoteiuic/coexecutesthe command line. 

9.3 Uiu - System To System Execution 

The uux command is used to set up the e.iecutitni of a XENIX command where the 
execution machine and/cr some of the files we lemote. The syntax of the uux 
command is 

uux [ — ] [ option ] ... comnumd— string 

where command— string is made up of one or more arguments. All special shell 
diaracters such as "<>i*" must be quoted either by quoting the entire command 
stringorquotingthecfaaracterasaseparateargument. Within the command string, the 
coomiand and file names may contain a system- name! prefix. All arguments which 
do not contain a "!** will not be treated as files. (They will not be copied to the 
execution machine.) The - option is used to indicate that the standard input for the 
givencommand shouldbe inherited firom the standard ii^tof theuiaconunand. The 
options, essentially for debugging, are: 

-r OonotstaitniMr/cooriaa^rafierqueuingtfaejob 

—Ttnum Usenumasthelevelofddwggingoutput. 

The command 

pr abc i uux - usg!^ 

will set iq> the output of * 'prabc" as standard iqxit to an Ipr command to be executed on 
system iMj. 

Uux generates an execute file which contains the names of the files required for 
execution (including standard input), the user's login name, the destination of the 
standard output, and the command to be executed. This file b cither put in the ^pool 
directoiy for local execution or sent to the remote ^stem using a generated send 
command (type3 above). 

For required files which are not on the execution machine, uux will generate receive 
command files (type 2 above). These coomund- files will be put on the execution 
machine and executed by the uucico program. (This will work only if the local system 
has permission to put files in the remote spool directory as controlled by the remote 
USERFILE. ) 

The execute file will be processed by the uia^r program on the executionmadiine. It u 
made iq> of several lines, eadi of which contains an identification character and one or 
more arguments. The order of the lines in the file is not relevant and socac of the lines 
maynotbepresent. Eadilineisdescribedbelow. 

User Line 

U user system 

where the luer and ^tfem are the requester's login name and system. 
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Required Fae Line 

F filename real— name 

where ihc filename is the generated name of a file for the execute madiine and real- 
name is the bst part of the aaual file name (coitains no path infcmnation) Zero or 
morcof these lines auiy be pre sent in theexecute file. The tuo^i program will dicck for 
the existence of allrcquired files before the command is executed. 

Standard Input Line 

1 filename 

The standard input is either specifiedby a **<" in the command-string or inherited 
£rom the standard input of the uux cominand if the - option is used. If a suodard input 
is not specified, /(^'/nu/Zisused. 

Standard OutputUne 

O filename system— name 

The standard output is q)ecified by a **>" within the command— string. If a standard 
output is not specified, Idevlmlt is used. (Note that the use of "»" is not 
implemented.) 

Command Line 

C command \ arguments ] ... 

The arguments are those specified in the coounand string. The standard input and 
standard output will not appear on this line. All required files will be movol to the 
execution directory (a subdirectory of the ^pool directory) and the XENIX command is 
executed using the Shell specified in the uucp. h header file. In addition, a shell PATH 
statement isprepended to the command line as specified in the lou^rprogram. 

After execution, the standard outputbcopied or set upto be senttotheproperi^ace. 

9.4 Uucico - Copy In, Copy Out 

The UUCICO program will perfonn the foUowingmajor functions: 

— Scan the spod directory for work. 

— Place a call to a remote system. 

— Negotiatealineprotocoltobeused. 

— Executeallrequestsfitnnbothsystems. 

— Log workrequestsand work completions. 

Uucico may be started by a system daemon, by one of the uucp . uux , uuxqt , ix uucico 
programs, by the user (this is usually for testing), or by aremote system. (The uucico 
program should be specified as the shell field in the letclpasswd file for the uucp 
logins.) 

When started by method a daemon, a program, or the user, the program is considered 
to be in MASTER mode. In this mode, aconnection will bemadetoaremote^stem. If 
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staitedbyaFemctesystem. the program is considered tobe inSLAVEmode. 

The MASTER mode will operate in one of two ways. If no system name is specified (the 
- s option not specified) the {wogram will scan the spooldirectory for systems to call, if 
a system name is specified, that system will be called, and work will only be done for 
that system. 

The uucico program b generally started by anolha program. There arc sevcralo|>tions 
used for execution: 

-rl Start the program in MASTER mode. This is used when uudco is started 

bya program or cronsheO. 

— ssys Do work only for system sys. If — s is specified, a call to the specified 
system will be made even LT there is no work for system sys in the spool 
directory. This is usefiil for polling systems which do not have the 
hardware to initiate a connection. 

The following operionsare used primarily for debugging: 

-ddir Usediiectofyd&-forthespooldirectofy. 

-xnum Useimmasthelevelofdebuggingoutput. 

The next pan of this section win describe the miyor steps within the uiicicopfogram. 

9.4.1 Scanning F«rWoilL 

The namesofthe wockrelated files in the iqwbl directory have format 

type . system— name grade manber 

where type may be "C" for copy command file, "O" for data file, "X" for execute 
file, system-name is the remote system, grade is a diaracter. and number is a four 
digit, padded sequence number. 

The file 

C.res4Sn0031 

is a woric file for a fik transfer between the local machine and the res45 machine. 

The scan for work is doac by looking through the qwol directory for work files (files 
with prefix C. ). A list b made of all systems to be called. Uucico will then call each 
system and processall workfiles. 

9.4.2 Calling a Remote System 

The caU is made using information from several files which reside in the uucp program 
directory. Ai the start of the call process, a lock is set to forbid multiple conversations 
bet ween the same two systems. 

The system name b found in the L. jrys file. The informatiottcontained for each system 
b; 
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|l| System name 

I2I Timestocallihcsystcm(days-of-weckaiidumcs-of-day) 

[3] DeviceordevicetypctobeusedforcaU 

[4] line speed 

[s] fhonc number if field [3] is " ACU " or the device name (same as field [3]) 

if not 

[6] Login infonnation (multiple fields) 

The time field ischecked against thepresent timeto see if thecal! shouldbemade. 

The phcm£ number may contain abbreviations (e.g. mh. py, boston) wliicfa get 
translated intodial sequencesusingtheL— cfio/cMie^file. 

The L -</mr» file is scanned using device type and line speed fields from t}» L.^5 file 
to find an available device for the call. The program will try all devices v^iich satisfy 
these fields until the call is made, or no more devices can be tried. If a device is 
successfully opened . a lock file is created so that another copy of uucico will net tiy to 
use it . If the call is complete, the kigin information n the last fieU ofL.sys is used to 
logia 

The conversation between the two uucico programs begins with a handshake started 
by the SLAVE system. The SLAVE sendsamessage to let the MASTER know it is ready 
to receive the system identification and conversation sequence nmiber. The response 
from the MASTER is verified by the SLAVE and if acceptable, protocol selection 
begins . The SLAVE can also repfy with i can— badE required message in which case, 
the cuirentconversationis terminated. 

9.4^ Selecting Line Protocol 

The remote system sends a message 

Pproto—list 

where/iroro— ^.sfisastringof characters, each representingaline protocol. 

The calling program checks the protocol list for a letter corresponding to an available 
line {Hxxocol and returns a use (Mfotocol message. The message has the form 

Vcode 

where code is either a one character protocol letter or "N " which means there is no 
commonprotocol. 

9.4.4 Processing Work 

The initial role of MASTER orSLA VE forthe work processing is the mode in which each 
program starts. (The MASTER has been specified by the -rl option.) The MASTER 
program does a w<vk search similar to the one used in the section "Scanning For 
Work" above. 
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There are five messages used during the work processing, each specified by the first 
character of the message. They are; 

S Send a file 

R Receive a file 

C CopycofDplete 

X Executeauiur/icommand 

H Hangup 

The MASTER will send R,S, or X^oiessages until all work firom the spool directory is 
complete, at which point an // message b sent. The SLAVE will re^y with the first 
lener of the request and either the letter "Y" or "N*'foryesor no. For example, the 
message "SY"indicatesthja it isokaytosendafile. 

The send and receive rq>lies are based on permission to access the requested 
file/directoiy using the USERFILE and read/write permissions of the file/direaoiy. 
After each file is copied into the spodi directory d[ the receiving system, a copy- 
complete message is sent by the receiver of the file. The message "CY" willbesentif 
the file has successfully been moved from the temporary spool file to the actual 
destination. Otherwise, a "CN" message is sent. (In the case of "CN", the 
transferred file will be in the spo(d directory with a name beginning with * TM *.) Ihe 
requestsandresuksare logged onboth systems. 

The hangup response is determined by the SLAVE program by a work scan of the spool 
directory. If woik for the remote system exists in the SLAVE'S spool directory, an 
"HN" message is sent and the programs switch roles. If no woik exists, an "H Y" 
response is sent. 

9.4.5 Termiiwting a Conversation 

When a ' *H Y" message isreceived by the MASTER it b edioedback to the SLA VE and 
the protocols are turned off. Each program sends a final * 'OO* * message to the other. 
The original SLAVE program will clean up and terminate. The MASTER will proceed 
to call other systems and process work as long as possible or terminate if a —s option 
was specified. 

9.5 Uuxqt - Uuq» Command Execution 

The uaxqt p rogram b used to process execute files generated by imx. The uiu^r 
program nuy be started by either the Micico or ma programs. The program scans the 
spool directory for execute files (prefix X. ). Eadi one is checked to see if all the 
required filesare available and if so, the command line or send line isexecuted. 

The execute file bdescribed in the section"Uux - System toSy stem Copy *' above. 

Theexecutionbaccompliafaedl^executingthesheUcooniand 

sh-c 

with the command line after apfm^iriate standard input and standard output have been 
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opened, if a standard output is specified, the prograin will create a send cmunand or 
copy the output file as appropriate . 

9.6 Uulog - Uucp Log Inquiry 

The uucp programs create individual log files for each program invocation. 
Periodically, uulog may be executed to append these files to the system logfilc. This 
method of logging was diosen to minimize file locking of the logfile during (Hogram 
execution. 

The uulog program merges the individual log files and outputs specified log entries. 
The output request is specified by the use of the following options: 

—ssys Printentrieswhere^sistheremotesystcmname 

—uuser Printentriesforuseru^er. 

The intersection oi lines satisfying the two options is output . A null sys or user means 
all system namesor users respectively. 

9.7 Uuclean - Uucp Spool Directory Cleanup 

This program is typically started by the daemon, once a day. Its function is to remove 
files from the spool direaory whidi are more than three days oM. Tliese arc usually 
files for worii wdiich can not be completed. 

The options available are: 

—ddir Thedirecto(ytobescaimedis(&>. 

— m Send mail to the owner ofeach file being removed. (Note that most files 

put into the spool directory will be owned by the owner of the uucp 
programs since the setuid bit will be set on these jxograms. The mail will 
therefore aiost often go to the owner of the uucp |»x)grams . ) 

—nhours Changptheagingtime&om72hourstoA0ur5hours. 

~ppre Examine files with prefix />r« for deletion. (Up to 1 file prefixes may be 
specified.) 

—xiutm Usenum asthelevelofdebuggingoutputdesired. 

9.8 Security 

The uucp system, left unrestricted, will kt any outside user execute any commands 
and copy in/out any file whichisreadable/writableby the uucp login user. It isuptothe 
individual sites to be aware of this and apply the {mxeaions ttua they feel are 
necessary. 

There are several security features available aside firom the normal file mode 
protections. These must be set up by the installer of the uurp system . 
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The login for uuq) does not get a sumdord shell. Instead,the«uc/C0pcogramisstaited. 
Therefofc , the only work thai can be done is through uxicico . 

A path check is done on file names that arc to be sent (v received. The USERFILE 
suppliestheinformationforthesechecks. TheC/5£RF/L£canalsobesetuptorequire 
call -bade for certain login- ids. See the section "Required Files" below in this 
chapter. 

A conversation sequence count can be set up so that the called system can be more 
confident that the calfer is whohe say she u. 

The wtxqt progra m comes with a list of commands that it will execute. A PATH sheO 
statement is {»epended to the command line as specified in the uuxqt program. The 
insuller may nK>dily the list orrcmovetherestrictionsasdeared. 

The L.sys file should be owned by uucp and have mode 0400 to |xotect the phone 
numbers and login information for remote sites. (The uw:p , uucico , uux , and uuxqt 
should be also ownedby uucpand have the setuidbit set.) 

9.9 InstaUing a Uuqi System 

The uucp system provided with the XENIX Software Development System u already 
configured for operation on your con^Miter. Toinstall the system, you must edit a few 
files to fvovide information about your local site. The following sections provide an 
overview of the files to be edited and the infoimaticHi required. 

During execution of the uucp programs, the uucp system uses fifes from the following 
three directories: 

program {/usr/libfuucp) This is the directocy used for the executabk system 

ptogramsand the system fiks. 

spool (/usr/spod/uucp) This is the spool directory used during uucp 

execution. 

xqtdir (/iM/y5poo//iitKrp/.JrQ7D/J?)Thisdirectoiyisusedduringexecutionof 

execute fifes. 

The names given in parentheses above are the defaub values for the directories. The 
names lib , program , xqtdir , and spool will be used in the following text to represent 
the appropriate directory names. 

9.9.1 ModiTyiiig the letclsystanid Fife 

You must choose a unique site name for each computer to be directly connected to a 
uucp line and add the site name to the letclsyaemid file of the corresponding computer 
by using a XENIX text editor. The/eic/^yj/eimV/fifecanactuallycontaintwonames: the 
uucp site name, which must appear on the first line of the file, and a Micnet machine 
name, which must appear on the next line. Howeva, you may decide to have both the 
uucp site name andMicnet madiine nameto be the same, in >»1iich case, onl^ one name 
is required. For a description of the fife, see aystemidlM) in the XENIX R^erence 
Manual. 
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9.9.2 Creating the Required Files 



There arc four Gles which arc required for execution, all of which rhould reside in the 
program directory . To prepare the uucp system for execution, you must add your own 
site specific information to these files by editing the files with a XENIX text editor. The 
field scparatorfor all filcsisaspace unless otherwise specified. 

L-devkcs 

This file contains entries for the call— unit devices and hardwired connections which 
aretobeusedbyuiicp. Thespecialdevicefilesareassumedtobeinthe/itfvdirectoiy. 
The foimat for each entry is 

line caU—unit speed 

where Une is the device for the line (e.g. culO), call-unit is the automatic call unit 
associated with tine (e.g. cuaO). Hardwired lioeshave a number ' *0* ' in this field, and 
5/)eeJistheline speed. 

The line 

culO cuaO 300 

defines a system wiiich has device "culO" wired to a call— unit "cuaO" fcvuseat3(X) 
baud. 

L-dialcodes 

This file contains entries with locationabbieviations used in the L.5yj file (e .g. py , mh, 
boston). Theentry format u 

abb dial— seq 

where abb is die abl»eviation, and dial— seq is the dial sequence to caU that location. 
The line 

py 165- 

causcs the ertrypy7777tobe expandcdto 1 65-7777. 

USERHLE 

This filecontainsuseraccesstbility information. Itspecifies 

— Thefilesthatcanbeaccessedbyanonnaluserofthelocalmadiine 

— ThefiksthatcanbcaccessedfromaremotecomputCT 

— The login name used by a paiticular remote computer 

— Whether a remote computer should be caUcd bade in order to confirm its 
identity 

Each line in the file has the foOowing format 

login,sys \ c | pathname \ pathname ] ... 

where /o^m is the login name for a user or the remote computer , 5}>f is the system name 
for a remote cranputer, c is the (^ional call-back required flag, and pathname is a 
pathname prefix that isaccq)table Uxuser . 
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It is assumed thai the login name used by a remote computer to call into a local 
computer is not the same as the login name of a normal user of that local machine. 
Howe ver , several remote computers may employ the same login nanw. 

Each computer is given a unique system name which b transmitted at the start of each 
call. This name identifiesthecallingmachinetothecalledmachiiie. 

When the program is obeying a coounand stored on the local machine, MASTER 
mode , the pathnames a Uowed are those given for the first line in the C/5£/{F//jE that has 
a login name that matches the login name of the user whoentered the cranmand. If no 
such line is found . the first line with a nu/Zloginname is used. 

When the program is re ^wnding to a coounand from a remote machine, SLA VE mode , 
the pathnames aUowed are those given for the first line in the file that has the system 
name that matches the system tuune of the remote machine. If no such line is found, the 
first one with a null system name is used. 

When a remote computer logs in, the login name that it uses must appear in the 
USERFILE. There may be several lines with the same login nante but one of than 
must either have the name of the remote systemor must containa null ^stem name. 

If a line is found that has the appropriate login and remote ^stem names and also 
contains a "c ", the remote machine is called back before any transactions take place. 

The line 

u,m /usr/xyz 

allows machine "m" to login with name "u" and request the transfer of files whose 
names start with "/usr/xyz* *. ** 

The line 

dan, ^sr/dan 

allows the ordinary user "dan" to issue commands for files whose name starts with 

"/usr/dan". 

The lines 

u,m /usr/xyz hxsr/spooi 
u, /ust/spixA 

allow any remote machine to login with name "u" , but if its system name is not "m", 
it can onfy ask to transfer files v^ose names start with * Vusr/spool* \ 

The lines 

root, / 
. /usr 

allow any user to transfer files beginning with ' */usr' ' but the user with login ' 'root** 
cantransfer any file. 

L.8ys 

Each entry in this file represents one system which can be called by the local uucp 
programs. The fiekls are described below. 

system nameThe name ofthc remote system. 
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tune This is a string whidi indicates the days - of- week and times— of— day 

when the system should be called (e.g. MoTuThOSOO- 1730). The day 
portionmaybealist containing some of 

Su Mo Tu We Th Fr Sa 

oritmaybe*'Wk"forany week— dayor*'Any**foranyday. The time 
should be a range of times (e.g. 08(X>-1230). If no time poition is 
iftecified , any time of day isassumed to be (A for the call. 

device Thisiseither"ACU"orthehardwiiieddevicetobeusedforthecall. For 
the hardwired case, the last pan of the special file name is used (e.g. ttyO). 

speed ThbisthelinespeedforthecaIl(e.g.3(X)). 

phone The fhovc number is made up of an optional alphabetic abbreviation and 
a numeric part. The abbreviation is one which appears in the L— 
dialcodes file (e.g. mhS900. boston99S-99gO). For the hardwired 
devices, this field contains the same striAg as used forthe device field. 

login The login infoimation is given as a series of fields and subfiekis in the 

focmat 

expect send f expect send ] ... 

«^re expect is the string expected to be read and send is the string to be 
sent when the expected string is received. The expect field may be oude 
upof subfieldsof the fonn 

expect] —send—expectl ] ... 

where send is sent if the prior expect is not successfully read and expect] 
is the next expected string. 

Tliere are two special names available to be seit during the login 
sequence. The string "EOT" sends an EOT characta and the string 
"BREAK* ' tries to send a BREAK character. (The BREAK character is 
simulated using line speed dianges and null characters and may not work 
on all devices and/or systems. ) 

A typical eitry in the L. sys file is 

sys Any ACU 3(X) mh7654 login uucp ssword: word 

The expect algorithm Uxks at the last part of the string as illustrated in the password 
field. 

9. 10 Maintaining the System 

This section indicates some events and files which must be maintained for the uucp 
system. You may do some maintenance with shell command files, initiating the files 
with crontab entries. Others will require annual modification. Some sample shell 
files are given toward the end of this section. 
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9.10.1 SEQF - sequence chedk file 

This file is set up inthcprogram directory and contains aneniiy for cachremote system 
with which you agree to perfonn conversation sequence diecks. The initial entiy u 
just the system name of the remote system. The first conversation will add two items to 
the line, the conversation count, and the date/time of the most resent conversation. 
These items will be updated with each convcrsatioii. If a sequence check faib, the 
entxy will ha vc tobe adjusted. 

Use ofthis featureunot recommend. 

9.10.2 TM - tnnparary data fiks 

These files are oeated in the spooi directoiy while files are being copied from a ranote 
machine. Theirnameshavetfaefonn 

TM. pid.ddd 

where i>u/ is a process— id and ii!c/</ b a sequential three digit number stalling at zoo for 
each invocationofiuMricoandincrementedfor each file received. 

After the entire remote fife is received, the TM fife is moved/copied to the requested 
destination. Ifprocesstngisabnormallytenninatedorthemove/copy fails, die fife will 
remaininthe spooldirectoiy. 

The feftover fifes should be periodical^ removed; the «ifc/«an program is useful in this 
regard. The command 

unclean -pTM 

removesall TMfilesolderthanihreedays. 

9.103 LOG - log entry Acs 

During execution of programs, individual LOG fifes are created in the spool directory 
with infonnation about queued requests, calls to remote systems, execution of uux 
commands and file copy results. Thesefifesshouldbecambinedintothe£/X//7LEby 
using the uuiog program . This |xogram will put the new LOG files at the beginning of 
theexistingLOGF/ZJ?. Thecommand 

uulqg 

perfotms the merge. Options are availabfe to print some or all the log entrks after the 
fitesaremerged. The LOGF/^Aouldbe removed periodically anceitiscopiedeach 
time new LOG entnesareput intothe fife. 

The LOG files are created initially with mode 0222. If the program which creates the 
fife terminates normally, it changesthe mode to0666. Aborted runs may feave the fifes 
with mode 0222 and the uulog program will not read or remove them. To remove 
them . either use nif , luic^dii , or change the mode to 0666 and let uti/o; merge them 
withtheLOCFlLE. 
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9. 10.4 STST - system status files 



These files are created in the ^pool direciory by the uucico program. They contain 
infocmation of failuies such as login, diahip or sequence check and will contain a 
talking status whentomachinesare conversing. The form of the file name is 

STST.jys 

where sys isthe remote system name . 

For ordinary failures (dialup, login), the file will prevent repeated tries for about one 
hour. For sequence check failures, the file must be removed before any future attempts 
to converse with that remote system. 

Ifthe file is left due toanabofted run, it may containataOdng status, in thiscase, the file 
mustberemovedbcforeaconversationisatteinpted. 

9.10.5 LCK- lock files 

Lock files are created for each device in use (e.g. automatic calling unit) and each 
system conversing. This prevents duplicate conversations and multiple attempts to 
usethe same devices. The form ofthe lock file name is 

LCKstr 

where str is either a device or system name. The files may be left in the spool directory 
if runs abort. They will be ignored (reused) after a time ofabout 24 hours. When runs 
aboit and calls are desired before the time limit, the lode files should be removed. 

9.10.6 CrcatiacShd] Files 

The uucp program will ^xx>l woik and attempt to start the uucico program, but the 
starting of uucico will sometimes fail. (No devices availabfe, login failures etc.). 
Therefore , the uucico program should be periodically started. The command to start 
uucico can be put in a shell file with a command to merge LOG files and started by a 
crontabenttyonanhourlybasis. Utefilecouldcontainthecommands 

program /uulog 
(vogram /uucico — rl 

Note that the — rl option is ret^ired to start the uucicoprogram in MASTER mode. 

Another shell file may be set up on a daily basis to remove 7A/, 57, and LCilT files and 
C.orD. files for work w^icfa can not be accomplished for reasons like bad phone 
number, login diangesetc. A sheU file containing ccnomands like 

program /uuclean — pTM — pC. —pD. 
program /uuclean -pST -pLCK -nl2 

can be used. Note the -nl2option causes the^T and LC#r files oMcrthan 12hoursto 
be deleted. The absence ofthe — noption will use a three day time limit. 
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9. 10.7 Defining Login Entries 

One or more logins should be set up for uucp . Each of the JetcJpasswd entries should 
have programluucico as the shell to be executed (where program is the directory 
containing uucico). The login directoiy is not used, but if the system has a special 
directory for use by the users for sending or receiving file, it should as the login entry . 
The various logins are used in coqunction with the USERFILE to restrict file access. 
Specifying the shell argument limits the lo^ to the use of uucicoonly. 

9. 10.8 Setting File Modes 

It is suggested that the owner and file modes of various programs and files be set as 
follows. 

The |»ograms uucp , uux , uucico , and uuxqt should be owned by the uucp login with 
the sctuid bit set aiid only execute permissions (e.g. mode 041 1 1). This will prevent 
outsiders from modifying the programs to get at a standard shell for the iiurp logins. 

The L.sys, SQFILE, and USERFILE files wfaidi are put in the program directoiy 
should be owned by iheuucp login and set withmode 0400. 
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10.1 Introduction 

The C— shell (Mxtgram, csh. is a ccnxunand language inteqxeter for XENIX system 
users. The C- shell, like the standard XENIX shell jA . is an interface between you and 
the XENIX coaunamls and programs. It translates command lines typed at a tcnninal 
imo corresponding system actions, givesyouaccesstoinfoimation, such as your login 
name, home directory, and mailbox, and lets you construct of shell procedures for 
automating system tasks. 

This chapter explains how to use the C— Aell. it also explains the syntax and function 
of C-shcll commands and features, and showsbowtousetliesefeaniresio create shell 
procedures. The C-dieD is fully described in csh{CP) in the XENIX Reference 
Manual. 

10.2 Invoking tiie C-shell 

You can invcrfce the C— shell from anothCT shell by using the csh command. To invoke 
the C— shell, type: 

csh 

at the standard shell's command line. You can also direct the syston to invoke dte 
C- sheU for you w^en you log in. if you ha ve given the C- sheO as your login shell in 
ycm I etclpasswd file entry, the system automatically starts the shell whenyou log in. 

After the system starts the C— shell, the shell seardies your home directory for the 
command files . cshrc and . login . if the shell finds the files, it executes the commands 
contained in them, thendisplays the C~ shell prompt. 

The xshrc file typically contains the commands you wish to execute each time you 
start a C— shell , uid the .login file contains the commands you wish to execute after 
logging in to the qrstem. For example, the following is the contents of a typical .login 
file: 

set ignoreeof 

set mail=(Aisr/spnol/mail/bill) 

set time= 15 

set history =10 

mail 

This file contains several set commands. The set command is executed directly by the 
C- shell; there is no corresponding XENIX program for this ccnmuind. Set sets the 
C- shell variable "ignoreeof which shields the C- shell from logging out if 
CNTRL-O ishit. Instead of CNTRL-D, the logout coomiand is used to log out of the 
system. By setting the "mail" variable, the C-sfaell is notified that it is to watch for 
incomingmailand notify you if newmail arrives. 

Next the C-sheU variable "time" is set to IS causing the C— shell to autcxnaiically 
print out statistics lines for commands that execute for at least 1 S seconds of CTU time. 
Tlie variable ' 'history* ' is set to 1 indicating that the C— shell will remember the last 
lOcommands typed initshistc^ list, (described later). 

Finalfy, the XENIX /na/7(»ogram is invdced. 

When the C- shell finishes processing the .login file, it begins reading commands 
from the terminal, prompting for eadi with: 
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% 

Whenyou logout (by giving the Iogoutcoiniiiand)theC- shell fvints 

logout 

and executes conunands from the file ./o^ou/ifttexists in your home directoiy. After 
that. theC-shelltenninatesand XENIX logsyouofTthe^stem. 

10.3 Using SheU Variables 

The C-shell maintains a set of variables. For example, in the above discussion, the 
variables ' 'hisiocy " and ' 'time" had the values 10 and 1 S. Each C— shell variable has 
asits valueanarrayofzeroormorestriogs. C— shell variablesmay be assigned values 
by the set comnand . whichbas several fonns, the inost useful of ixduch is: 

set iume=vabie 

C- shell variables may be used to store vahies that are to be used later in commands 
through a substitution mechanism. The C— shell variables most commonly 
referenced are, however, those that the C— shell itself refers to. By changing the 
valuesof these variablesyou can directtyaffect the behavior of theC-shell. 

One of the most in^xxtamvariablesis "path". This variable containsalist of directoiy 
names. Whenyoutypeacommandnameatyourterminal,theC-shellcxamineseach 
named directory in turn, until it finds an executable file whose name cocrespoods to the 
name you typed. The set command with no arguments displays the vabies of all 
variables currentfy defined in the C-shell. The following example shows a typical 
default values: 



argv 





home 


/usr/biD 


path 


(. /bin/ua/bin) 


prompt 


% 


shell 


/bin/csh 


status 






This output indicates that the variable "path" begins with the current directory 
indicatedby dot( . ),\ben/bin, jmd/usr/Nn. Yourownlocalcommandsmay beinthe 
currentdirectofy. NonnalXENIXcoomuindsresidein/^iiand/iMr/fr/ii. 

Sometimesanumberof locally developed prc>gramsreside inthedarectory/ia//toca/. 
if you want allC— shells that you invoke to have access to these new pn^ams, place 
the command 

set path=(. /bin /uar/bin /usi/local) 

in the .cj/trcfik in your home directoiy. Try doing this, thenre—executing you. login 
withthecommandsoiuroe.log^ l>pe 

set 

to see that the value assigned to "patfa"haschanged. 

You ^oukJ be aware that «^en you log in the C- ^ell examines each directory that 
you insert into your path aiid detomines which craunands are contained there . except 
for the current directory which the C-shell treau speciaUy, This means th« if 
commands are added to a directocy in your search path after you have started the C- 
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shell, they will not necessarily be found. If you wish touscacoaunandwhichhas been 
added afta you have logged m. you should give the commaiid 

rehash 

to the C— shell. Rehoah causes the shell to recompute its internal table of command 
locations, so that it will find the newly added command. Since theC—shellhastolook 
in the cuncit directocy on each command anyway, placing it at the end of the path 
specificationusually work n best and reduces overhead. 

OthCT useful built in variables air "home" which shows your home directory, and 
' 'ignoreeof ' which can be set in your .login file to tell the C— shell not to exit when it 
receives an end-of- file firom a tcnninal. The variable "ignoreeof is one of several 
variables whose value the C— shell does not care about; the C— shell isonly concerned 
with whether these variables are set or unset. Thus, to set "ignoreeof you simply 
type 

set ignoreeof 

andtounsetittype 

unset ignoreeof 

Some other useful built— in C— shell variables are "noclobber" and "mail". The 
syntax 

>filename 

which redirecu the standard output of a comjnand just as in the regular shell, 
overwrites and destroys the previous contents of the named file, in this way, you may 
accidentally overwrite a file which is valuable. If you prefer that the C- shell not 
overwrite files in this way you can 

set noclobber 
in your .to^/ft file, typing 

date > DOW 
causesanerrormessageifthefilemnvalreadyexists. Youcantype 

date >! now 

if you really want to overwrite the contents of new. The "> !" is a ^cial syntax 
indicating that overwriting or "clobbering" the file is ok. (The space between the 
exclamation point (!) and the word "ix>w" is critical here, as "!now" would be an 
invocation of the history mechanism, described below, and have a totally different 
effect.) 

10.4 Using the C-SbeU History List 

The C— shell can maintain a history list into which it places the text of previous 
commands. It is possible to use a notation that reuses commands, or woids firom 
commands, in forming new oxnmands. This mechanism can be used to repeat 
{Mcvious commands or to correct minor typing mistakes in commands. 

The following figure gives a sample session involving typical usage of the history 
medxanianoftheC— shell. Boldface indicates user input: 
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% cat bug.c 
mainO 



(nrimfCheUo); 

I 

%cc!$ 

cc bug.c 

Ivug.c", line 4: newline in string or char constant 

'Iwg.c^. line S: syntax emr 

%edl$ 

ed bug.c 

29 

4s/)/'&/p 

printfClielloO; 
w 
30 

4 

%!c 
cc bug.c 
%a.ODt 
helk>% !e 
cd bug.c 
30 
4s/loi/Io\Wp 

printfClieUcKn'); 
w 
32 

q 

% le —o bug 

cc bug.c — o bug 

% size a.oat bag 

a.out: 2784+364+1028 = 4176b = 0x1050b 

bug: 2784+364+1028 = 4176b = OxlO50b 

% b -1 !• 

Is -1 a.out bug 

-rwxr-xr-x 1 biU 3932 Dec 19 09:41 a.out 

-rwxr-xr-x 1 biU 3932 Dec 19 09:42 bug 

%bag 

hello 

% !»> bug.c I Ipt 

Ipt: Conunand not found. 

% Ipt'lpr 

pr bug.c I Ipr 

% 

In this example, we have a very srmfic C program that has a bug or two in the file 
bug.c, which we cat out on our tenninal. We then try to run the C compiler on it. 
referring to the file again as "!$**, meaning the bst arguuKnt to the previous 
coomiand. Here the exclamation mark (!) is the history mechanism invocation 
meucharacter, and the dollar sign ($) stands for the last argumeit, by analogy to the 
dollar sign in the editor which stands for the end-of- line. The C— shell edioedthe 
command, as it wouMhave been typed withoutuseofthehistory mechanism, and then 
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executed the command. Thccompibtionyieldcderrordiagnostics, sowcnowediiUic 
file we were trying to ccHiipik, fix the bug. and run the C compiler again, this time 
referring to this command simply as " !c" , which repeats the last command that started 
with the letter "c". If there were other commands beginning with the ktter "c" 
executed recently, we could have said "!cc" or even "!cc:p" which prints the last 
command starting with "cc" without executing it. so thatyou can check to see whether 
you really want toexecuteagivencommand. 

After this recompibtion, we ran the resulting a. our file, and then noting that there still 
was a bug. ran the editor again. Afta fixing the program we ran the C compiler again, 
but tacked onto the command an extra "-o bug** telling the compUer to place the 
resultant binary in the file bug rather than a.our. In general, the history mechanisms 
may be used anywhere in the formation of new commatxls. and other characters may 
be placed before and after the substituted commands. 

We then ran the size command to see how large the binary program images we have 
created were, and then we ran an "Is -I" command with the same argument list, 
denoting the argument list: 

I* 

Finally , we ran the program te^ to sec that its output i s indeed correct . 

Tomake a listing of the iMX>gram. we ran the pr command on the file^^.c. Inorderto 
print the listing at a linepriitter we piped the output tolpr, but misspelled it as " Ipt" . To 
correct this we used a C- shell substitute . placing the old text and new text between 
caret (*) diaracters. This b similartothe substitute command in the ediux. Finally, we 
repeated the same command with 



and sent its output to the lincfmnter. 

There are other mechanisms available for repeating commands. The history 
command prints out a numbered list of (nrvious commands. You can then refer to 
these commands by number. There is a way to refer to a previous command by 
searching for a string which appeared in it. and there are otha". less useful, ways to 
select arguments to inchide in a new command. A annplete description of all these 
tae(i)Mdsmsisg^venincsh{CP)\hcXESlXReference Manual . 

10.5 Using Aliases 

The C~ shell has an alias mechanism that can be used to make transformaticKis on 
coDomands immediately after they are input . This mechanism can be used to simplify 
the commands you type, to supply defauh arguments to commands, or to perfnm 
transfnmations on commands and their arguments. The alias facility is similar to a 
macro facility. Some of the features obtained by aliasing can be obtained by using 
C— shell command files, but these take place b another instance of the C— ^ell and 
cannot directly affea the current C- shell's environment or involve commands such 
as cd which must be done in the current C— shell. 

For example, suppose there is a new version of the mail program on the system called 
newmail that ymi wish to use instead of the standard mail program mail. If you place 
the C- shell ccnnmand 
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alias mail newmail 

in your .cf Arc file , the C- shell will transform an input line of the form 

mail bill 

intoacaU onnewmail . Supposeyou wish the command Is to always show sizesof files, 
thatis.toalwaysusethe— soption. In this case, you can use the dias command to do 

alias Is Is ~s 
or even 

alias dir Is — s 
creatinganewcoounandnameddir. If wethentype 

dir-bUl 
the C- shell translates thisto 

Is -sAisr/bill 

Note that the tilde Q is a special C— shell symbol that represents the user's home 
directory. 

Thus the aJiascommand can be used to provide short names for commands, to provide 
default arguments, and todefine new short commands in tenns of other commands, it 
is also possible to define aliases that contain multi|4e commands orpipelines, showing 
where the arguments to the original coamund are to be substituted using the facilities 
ofthehistorymedumism. Thusthedefinition 

alias cd 'cd \!* ; b * 

specifies an b command after each cd comnoand. We enclosed the entire alias 
definition in single quotation marks ( ' ) to jwevent more substitutions bona occurring 
and to prevent the semicolon (:) firom being recognized as a metacharacter. Tlie 
exclamaiionmarli: (!)isescaped withabackslash (\)to|vevent it from being interpreted 
when the alias command is typed in. The "\! *" here substitutes the entire argumem list 
to the prealiasing od command; no error is given if there are no arguments. The 
semicolon separating commands is used here to indicate that one command is to be 
done and thenthe next. Similarly the followingexan^le definesacommand that looks 
up its first argument in the password file. 

alias ^ou *grep \!* /etc/passwd* 

The C-shell currently reads the .cshrc file each time it starts up. if you i^ace a large 
number of aliases there, C- shells will tend to start slowly . You should try to limit the 
number of aliases you have to a reasonable number ( 1 or 1 5 is reasonable). Too many 
aliases causes delays and makes the system seem sluggisii when you execute 
coDunands from within an editor or otherprograms. 

10.6 Redirecting Input and Output 

In addition to the standard output, commands also have a diagnostic output that is 
n(»mally directed to the terminal even when the standard output is redirected to a file or 
a pipe, it b occasionally useful to direct the diagnostic outjHit along with the standard 
output. Fbrinstance.ifyouwanttoredirecttheoutputofalongrunningcommandimo 
a file and wish tohave areccrd of any enor dbgixMtic it producesyou cantype 
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command >&filc 

The " > &" here tells the C— shell to route both the diagnostic output and the standard 
outfwtintoyi/tf. Similarly you cangive the command 

command t St Ipr 

to route boch standard and diagnostic outfHit through the pipe to the lineprinter. The 
form 

command >&! file 
is used when * 'noclobber* * is set anAfile already exists. 
Finally, use the fonn 

command » file 

to append output to the end of an existing file. If "noclobber" is set, then an error 
resultsif/E^doesnotexist.otherwisetheC— shellcreatesyi/ir. Theform 

cooomand »! file 

lets you append toafileeven if itdoesiKitexistand"noclobber" is set. 

10.7 Creating Background and Foreground Jobs 

When one or vaxxt commands are typed together as a pqwline or as a sequence of 
commands separated by semic(4ons, a single job is created by the C— shell consisting 
of these commands together as a unit. Single commands without pipes or semicolons 
create the snnplest jobs. Usually, every lineQrpedtotheC—shellcreatesajob. Eachof 
the following lines createsajob: 

sort < data 

Is — s t sort — n I head —5 

mailharold 

If the ampersand metacharacter (&) is typed at the end of the commands , then the job is 
started as a background job. This means that the C— shell does not wait for the job to 
finish, but instead, immediately prompts for another command. The job runs in the 
background at the same time that normal jobs, called foreground jobs, continue to be 
read and executed bytheC- shell. Thus 

du > usage & 

runs the </u program, vtdiich reports on the didt usage of your working directory , puts 
the output into the file usage and returns inunediately with a prompt for the next 
coomuuid without waiting for <& to finish. The <iu program continues executing in the 
background until it finishes, even though you can type and execute more commands in 
the meantime. Background jobs are unaffected by any signals fiom the keyboard such 
asthelNTERRUPTor QUIT signals. 

The kfll command terminates a background job immediately. Normally, this is done 
by specifying the process number of the job you want killed. Plocess numbers can be 
found with thepscommand. 
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10.8 Using Built-in Commands 

Thissectionexplainshowtouse some of the buih-inC-shell commands. 

The alias command described above is used to assign new aliases and to display 
existing aliases. If given no arguments, alias prints the list of current aliases. It may 
also be g^ven one argument, such as to show the current alias for a given string of 
diaracters. Fbrexample 

alias Is 

printsthe current alias for the string "Is". 

The history command displays the contents of the history list. The numbers given 
with the history events can be used to reference previous events that are difficult to 
refoence contextually. There is also a C~diell variable named "prompt**. By 
placing an exclamation point (!) in its value the C- shell will substitute the number of 
the current command in the history list. Youcanusethisnuoibertorefertoacommand 
in ahistoiy substitution. Forexample. you could type: 

set prompl='\! % * 

Note that the exclamation mark (!) had to be escaped even within badulashes. 

The logout command isused to teimiiiate a login C--shell that has "ignoreeof * set. 

The rehash command causes the C— shell toreconopuie a table of command locations. 
This is necessary if you add a command to a directory in the current C— shell's search 
path and warn theC-shell to find it, since otherwise Uiehasiiiiig algorithm may teU the 
C - shell that the command wasn't in that directory vt^en the hash table was computed. 

The repeat command is used to repeat a cdmmand several times. Thus to make 5 
copiesofthe fileoiv in the fileyiveyoucouldtype: 

repeat S cat one » five 

The sctcnvctmmandcanbe used to set variables in theenvironment. Thus 

setenv TERM adni3a 

sets the vahieof the environment variable "TERM" to "admSa". The program fnv 
existstoprint out theenvironment. Forexample, itsoutputmightlodclike this: 

HOME=/usr/biU 

SHELL==/bin/csh 

PATH = :/usr/ucbVbinVusr/bin:Aisr/locaI 

TERM=adm3a 

US£R=biU 

The source command is used to force the current C- sheU to read commands firom a 
file. Thus 

source .cshrc 

can be used after editing inaduuQge to the .ciArc file that you wish to takeeffect before 
the next time you login. 

The tiine command is used to cause a command to be timed no matter how much CPU 
time it takes. Thus 
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time q> /eic/rc /usr/biU/rc 
displays: 

O.Ou 0.1s 0:01 8% 
Similarly 

time wc /etc/rc Aisr/bill/rc 

displays: 

52 178 J347/ctc/ic 
52 178 1347 Aisr/biU/rc 
104 356 2694 total 
O.lu 0.1s 0:00 13% 

This indicates that the qtcommand used a negligible amount of user time (u) and about 
1/lOth of a second system time (s); the elq>sed time was 1 second (0:01 ). The word 
count command wc used 0. 1 seconds of user time and 0.1 seconds of system time in 
less than a second of elapsed time. The percentage "13%" indicates that over the 
period when it was active the wc command used an average of 13 percent of the 
available CPU cyciesofthemachiiK. 

Hie u wdlas and unset commands are used to remove aliases and variable definitions 
fromtheC-diell. 

10.9 Creating Command Scripts 

It is posable to place commands in files and to cause C- shelb to be invcked to read 
and execute c<»nmands fixm these files, wbidti are called C— shell scripts. This 
section describesthe C— shell features that are useful whencieatingC— shell scrq)ts. 

10. 10 Using the argv Variable 

Acsb command script may be interpreted by saying 

csh script argument ... 

where scrifH is the name of the file containing a group of C- shell commands and 
<2/-^ume/trisasequenccofcommandargumeiSs.ThcC— shell places these arguments 
in the variable "argv" and then begins to read commands firom script. These 
parameters are then available through the same mechanisms that are used to reference 
any other C— shell variables. 

If you make the file 5cri>r executable by doing 

dmiod 755 scrqx 
or 

chmod -f-x script 

and then place a C— shell comment at the beginning of the C— ^cll script (i.e., begin 
the file with a number sign (#) ) then /bin/csh will automatically be invcAed toexecute 
script when you type 
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script 



If the file does ika begin with a number sign (#) then the standard shcU/binJsh will be 
used to execute it. 

10.11 Substituting SheU Variables 

After each input line is broken into words and history substitutions are done on it , the 
input line is parsed into distinct commands. Before each command is executed a 
mechanism know as variable substitution is performed on these words. Keyed by the 
dollar sign ($). this substitutionreplaces the namesof variables by their values. Thus 

echo $argv 

when placed in a command script would cause the current value of the variable "argv" 
to be edioed to the output of the C— shell scrqx. It is an error for "argv" to be unset at 
this point. 

A number of notations are provided for accessing cnnponents and attributes of 
variables. The notation 

$'!name 

expands to 1 if name b set or to if name is not set. It is the fundameital mechanism 
used for diecking whether particular variables have been assigned values. All other 
formsof referencetoimdefined variaUescause enors. 

The notation 

$#name 

expands to the number of elements in the variable "name". Toilhistrate, examine the 
following terminal session (input is in boldface): 

% set argv=(a b c) 

1 

% echo $#arKv 

3 

% unset «rgv 

% echo $?argv 



%ccho$argv 

Undefined variable: argv. 

% 

it is also possible to access the components of a variable that has several values. Thus 

$argv[l| 
gives the first component of "argv* * or in the example above ' V . S imilariy 

$argvf$#argv| 
would give "c", and 

$argvfl-2] 
would give: 
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ab 
Other notationsuseful inC— shell scripts are 

%n 
where R is an integer Thisisshoithandfor 

Sargvf n] 
the R 'th parameter and 

$* 
which is a shoithand for 

Sargv 
The form 

S$ 

expands to the process number of the ciurent C— shell. Since this process number is 
unique in the system, it is often used in the generation (rf^unique temporary fdenames. 
The form 

$< 

is quite special and is replaced by the next line of input read from the C— shell's 
standard input (not the scripi it is reading). This is use^l for writing C-*shell scripts 
that are interactive, reading commands from the terminal, or even writing a C— shell 
script that actsasafiltcr, reading lines fromits input file. Thus, the sequence 

echo ~n 'yes or no?' 
set a=($<) 

writes out the prompt 

yes or no? 

without a newline and then reads the answer iito the variable "a ' '.In this case "$ #a " 
isOifeitherablank line or CNTRL-Dis typed. 

One minordifference between "$r" and **$argv[n]" should be noted here. Thefonn 
* 'Sargvfn ]•* will yield an error if n is not in the range 1 -$#argv while ' *$n' * will never 
yield an out— of— range subscript error. This is for compatilnlity with the way older 
shellshandle parameters. 

Another important point is that it is never an errortogive a subrange of the fonn "n- **; 
if there are less than "n" components of the given variable then no words are 
substituted. A rat^e of the form "m-n" likewise returns an empty vector without 
giving an error when "m" exceeds the number of elancnts of the given variable, 
provided the subscripi ' V is in range. 

10.12 Using Expressions 

To construct useful C— shell scripts, the C— shell must be able to evaluate expressions 
basedonthevahiesof variables. In fact, all the arithmeticoperationsof the C language 
are available in the C- shell with the same precedence that they have in C. in 
particular, the operations "'==*' and "!-** compare strings and the operators "&i^ " 
and"l r'implcxDentthelogicalANDandORoperations. Thespecialoperators"='" 
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and "!'" arc similar to "==*' and **!=='• except that the strii^ on ihe right side can 
have pattern matching characters (like *, ? or[ and]). These operators test whetho- the 
string on the le ft matches the pattern on the right. 

The C— shcB also allows file enquiriesof the foim 

—1 filename 

where question mark (?) is rq>laced by a number of single characters. For example, 
the expression primitive 

"C filename 

teUs whcther^f name exists. Other [vimitivestest for read, write and execute access to 
the file, whether it isadirectory.or if it has nonzero length. 

It is possible to test whether a command tenninates normally, by using a primitive of 
the form 

\ command \ 

which returns 1 if the comnuind exits normally with exit status 0. or if the command 
terminates abnormal^ or with exit status nonzero. If more detailed information about 
the execution status of a command is required, it can be executed and the ' 'status" 
variable examined in the next command. Since "Sstatus" is set by every command, 
its valueisalwayschanging. 

For the full list of expression components, see csh(CP). in the XENDi Reference 
Manual. 

10. 13 Using the C-SbeU: A Sample Script 

A sample C- shell script follows that uses the ex|vession mechanism of the C— shell 
and some of its control stivaures: 
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# 

# Copyc copies those C programs in the specified list 

# to the directory '/backup if they differ firom the file* 

# already in '/backup 
# 

set noglob 
foreach i ($argv) 

if ($i !' *.c) continue # not « .c file so do nothing 

if (! -r "/badnjp/$i:t) then 

echo $i:t not in backup... not cpVed 

continue 
endif 

cmp -s $i '/backup/$i:t # to set Sstatus 

if (Sstatus != 0) then 

edio new backup of Si 

cp $i '/backup^$i:t 
endif 
cad 

This script uses the foreach command. The command executes the other commands 
between the foreach and the matching end. for eadi of the values given between 
parentheses with the luuned variable **i" vhkh is set to successive vahies in the list. 
Within this loop we may use the command break to stop executing the loop and 
continue to prematurely terminate one iteration and begin the next. After the foreach 
loop the iterat ion variable(/inthiscase)has the value at the last iteration. 

The "noglob" variable is set to prevent filename expansion of the members of 
"argv". This is a good idea, in general, if the arguments to a C- shell script arc 
fifenames which have already beenexpanded or if the arguments may contain filename 
expansion metacharacters. It is also possible to quote each use of a "$" variable 
expansion, but this isharder and lessreliable. 

The other controlconstruct isa statement of the form 

if ( expression ) then 
command 

endif 

The phcement of the keywords in this statement is not flexible due to the current 
implementation of the C— shell. The following two formats are not accepuble to the 
C- shell: 

if (expression) # Won't wmk! 
then 

command 

endif 
and 
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if (expression) then command endif # Won't work 
TheC— sheUdoes have another fonnof the if St atanenL 

if ( expression ) cranmand 

which can be written 

if ( expression ) \ 
command 

Here we have escaped the newline for the sake of appearance. The command must not 
involve " I *', "&." or ";" and must not be another control onmnand. The second 
fonn requires the final backslash (\) to immediately precede the end-of- line. 

The more general If statements above also admit a sequence of dse— if pairs followed 
by a single dscand an endif , for example: 

if ( expression ) then 

commands 
else if (expression ) then 

commands 



else 

commands 
endif 

Another impoitam medianism used in C— shell scripts is the colon (:) modifier. We 
can use the modifier :r here to extract the root of a filename or :e to extract the 
extension. Thus if the variable "i" hasthe value /m/u//bo.6a/- then 

echo $i $i:r $i:e 

produces 

/mit/foo.bar /mm/foo bar 

This example shows bow the :r modifier strips off the trailing ".bar" and the :e 
modifier leaves only the "bar". Other modifiers take off the last ccmqwnent of a 
pathname leaving the head :h or all but the last component of a pathname leaving the 
tail : t. These modifiers are fully described in the csh(CP) entry in the XENIX Reference 
Manual . It is also possible to use the command substitution mechanian to perfonn 
modifications on strings to then reenter the C- shell environmeil . Since each usage of 
this mechanism involves the creation of a new process, it is much more expensive to 
use than the colon (:) modification medianism. It b also important to note that the 
current implementation of the C— shell limits the inmiber of colon modifiers on a "$" 
substitution to 1 . Thus 

% echo Si $i:h:t 
produces 

/a/b/c /a/bn 

and does not do what you mightexpect. 

Finally, we note that the number sign character (#) lexically introduces a C— ^ell 
comment in C- shell scripts (but not from the taminal). All subsequeit characters on 
the input line after a number sign are discarded by the C- shell. This character can be 
quotcdusing'"'c»-"argument word. 
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10. 14 Using Other Control Structures 

The C- shell also has control structures while aixi switch similar to those of C. These 
take the forms 

«^ile ( expression ) 
commands 
end 

and 

switch ( word ) 

case strl: 

conunands 
breaksw 



case stra: 

commands 
brcaluw 

default: 

commands 
bicaksw 

endsw 

For details see the nuinual section for csb(CP). Cprogrammers should note that we use 
breakswtoexitfiromaswitch while break exitsawhleorforcachloop. Acommon 
mistake to make in C— shell scripts isto use break rather than breaksw in switdics. 

Finally, theC- shell allowsagotosutemcnt, with labels kx)king like they do inC: 

k>op: 

commands 
goto loop 

10. 15 Supplying Input to Commands 

Commands run from C— ^ell scripts receive by default the standard input of the C— 
sheU which is running the script, it allows C- shell scripts to fully panicq>ate in 
pipelines, butmandatesextranotationfor commands that are to take inline data. 

llius we need a metanotation for supplying inline data to commands in C— shell 
scripts. For example, considerthis script wfiidifunsthe editortodelete leading blaidu 
from the linesin each argument file: 
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# deblank — remove leading blanks 
foreach i ($argv) 
cd ~ $i « ' EOF* 

l.$s/1 ]*// 
w 

q 

•EOF 
end 

The notation 

« 'EOF 

coeans that the standard ii^nit for the cd command b to come firom the text in the C— 
shell script file up to the next line consisting of exactly EOF. The fact that the EOF is 
enclosed in single quotation marks ( * ). i.e. . it is quoted, causes the C— shell to not 
perform variable substitution on the intervening lines. In general, if any pan of the 
word following the * '« " which the C- shell uses to tenninate the text to be given to 
the command is quoted then these substitutions will not be perfonned. In this case 
since we used the form "1,$" inour editor script we needed to insure that this dollar 
sign was not variable substituted. We couU also have insured this by preceding the 
dollar sign ($)withabackslash(\),i.e.: 

l.NSsrf I*// 

Quoting theEOFterminatorbamore reliable way of adiieving the same thing. 

10.16 Catching Interrupts 

if our C- shell script creates temporary files, we aiay wish tocatdi iatenuptions (tf the 
C-^ell script sothatwecanckanup these files. Wecanthendo 

onintr l^>el 

where /la/v/ is a label in our program. If anintemiptisreceivedtheC— shell will doa 
"goto label" and we canrenoove the temporary fifes, thendo an exit command (wtidj 
is built in to the C- shell) to exit bcm the C- shell script. If we wi^ to exit with 
nonzero stmus we can write 

exit (I) 

to exit with status!. 

10. 17 Using Other Features 

There are other features of the C- shell useful to writers of C-shell procedures. The 
verbose and echo options and the related -" v and — x command line options can be 
used tohelp trace the actionsoftheC-sbell. The — n option causes the C— shell only 
toreadcommandsandnottoexecutethemandmaysometimesbeofuse. 

One other thing to note is that the C~ shell will not execute C- diell scripts that do nol 
begi n with the number sign character (#), that is C- shell scripts that do not begin with 
a comment. 

Thereisalsoanotherquotatioamechanismusingthedoublequotationmaikn> ^fibxh 
alk)ws only some of the expansion mechanians we have so far discussed to occur on 
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the quoted string and serves to make this string into a single word as the single quote ( ' ) 
does 

10.18 Starting a Loop at a Termmal 

It is occasionaUy useful to use the foreacb control structure at the terminal to aid in 
performing a number of similar commands. For instance, if there were three shells m 
use ona particular system . /^'n/jA .//m/i/asA , and/i>i/i/c5A , you couldcouit the number 
ofpersonsusingeach^ellbyusingthefoUowingcommands: 

grep — c cshS /etc/passwd 
grq;> — c nshS /etc/passwd 
grep -c -V sh$ /etc/passwd 

Since these commands are very similar we canuse foreacb to simplify them: 

S foKacb i CcsbS' *iisb$' *-v sb$') 
? grep -c U /etc/passwd 

?ClMl 

Note here that the C- shell prompts for input with " ? " when reading the body of the 
loop. Thisoccursonlywhentheforeacbcommandisentered interactively. 

Also useful with loopsarevariaUes that coitainlistsoffilenamesorother words. For 
example , examine the following terminal session: 

% set a=('kO 

%ccbo$a 

csh.n csh.im 

%b 

csh.n 

csh.rm 

% ccbo $#a 

2 

The set command here gave the variable "a** a list of all the filenames in the curreit 
directoiy as value. We can then iterate over these names to pcrfoim any chosen 
function. 

Thecnitputofacommand within bade quotationmarks( ' )isconvertedbytheC-*- shell 
to a list of words. You can also place the quoted string within double quotation maiks 
O to take each (nonempty) line as acomponeni of the variable. This prevents the lines 
from being split into words at blanks and tabs. A modifier :x exists which can be used 
later to expand each component of the variable into another variable by flitting the 
original variable into separate words at embeddedblanksand tabs. 

10. 19 Using Braces with Arguments 

AnothCT foim of filename expansion involves the characters, "(" and "j". These 
diameters specify that the contained strings, separated by commas (.) arc to be 
consecutively substituted into thecontainingcharacters and the resuksexpiandedleflto 
right. Thus 

A;strl,str2....stmjB 
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expands to 

AstrlB Astr2B ... AstrnB 

This expansion occurs before the other filename expansions, and may be applied 
recursively (i.e. . nested). The results of each expanded string are sorted separately, 
left to right order being preser\%d. The resulting filenames are not required to exist if 
nootherexpansionmechanismsareuscd. Thismeansthatthismechanismcanbeused 
to generate arguments which are not filenaoies, but which have common parts. 

A typical use of this would be 

mkdir 71idrs,retiofit,csh| 

to make subdirectc«ies hdrs , retrofit and csh in your home directory. Thisnoecfaanism 
is most useful whenthecommonpiefixis longer than in thisexample: 

diown root /usr/dcm(V|filel,filc2,...| 

10.20 Substituting Commands 

A ccmunand enclosed in accent sfymbols ( ' ) is refdaced, just before filenames are 
e;q>anded, by the output from that command. Thus, itispossible todo 

set pwd='pwd' 

to save the current directoiy in the variable * *pwd" orto do 

vi 'grep -I TRACE *.c' 

to run the editor vi supplying as arguments those files whose names end in .c which 
have the string 'TRACE" in them. Command expansion also occurs in input 
redirected with " « " and within quotation marks (")• Refer to csh(CP) in the XENIX 
Rfftrence Manual fcftnore information. 

10.21 Special Characters 

The followingtable lists the special characters of csb and the XENIX system. Anumber 
of these characters also have special meaning in expressions. See the csh manual 
section for a complete list. 

Syntactic metacharacters 

; Separatescommandstobeexecuted sequentially 

i Separatescommandsinapipeline 

Bracketsexpressionsandwiablevalues 

&. Followscommandstobeexecutedwithoutwaitingforcompletioa 

Filename metacharacters 

/ Separatescomyonectsofafile'spaThname 
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Separates root pans of a filename from extensions 
? Expansion character matching any singk diaracter 

* Expansioncharactermatchingany sequence of characters 

[ I Expansion sequencematching any single character from a set of diaractcrs 

Used at the beginning of a filename toindicate home directories 

II Usedtospecifygroupsofargumentswithcommonparts 
Quotation metacharacters 

\ Preventsmeta— meaningoffollowingsinglecharacter 

' Preventsmeta— meaning of a group of characters 

Like * , but allows variable and command expansion 
Input/outputmetacharacters 

< Indicatesredirected input 

> Indicates redirected output 

Expaosion/SubstitutionMetacharacters 

$ Indicates variable substitution 

! Indicateshistory substitution 

Precedes substitutionmodifiers 

Used inspecialformsofhistory substitution 

' Indicates command substitution 

Other Metacharacters 

# Beginsscratchfilenames;indicatesC-sheUcomments 
— Prefixesoption(flag)argumcntstocommands 
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L'sing The Visual Shdl 

11.1 What is the Visual SheU? 

The Visual SheU vsh is a menu -driven XENLX shell. This chapter describes the use 
and behavior of the vsh. This chapter assumes that the reader is familiar with some 
gcneralXENIX concepts, specificaUy the structureofXENIX filesystems and the nature 
of a XENIX 'command*. Nofamiliarity with any other shell, however, is assumed, if 
you are a first— time user of the Visual Shell, please completely read the narrative 
sections of this chq)ter . 

A 'sheU' is a program which passes a command to an operating system, and displays 
the resuh of running the conunand. The XENIX shells can also create 'pipelines' for 
passing the output of one command to another command or 'redirect * the output into a 
file. 

The other XENIX ^ells available are sh and csh. These shells are called 
'command- line orieitted' shells. This means that the user enters commands one line 
at a time. The sh and csh shells are fiill ctxnputer languages which require study and 
some programming knowledge to use effeaivcly. These command- line shells are 
powerful and ef&cieit . 

The vsh is a 'menu— oriented' shell. In a menu— oriented shell, the user is given the 
available commands, or some of the available commands. The user can run the 
command, by selecting from tbeoaeou. 

The Visual Shell is a good ^eU for users who may not want to master a programming 
language ri^t away just to use XENIX or a specfic XENIX application. All Visual Shell 
users should additionally become familiar with some command— line shell usage. 

Users familiar with command— line ^ells are in for a pleasant suiprise if they try tlie 
Visual Shell. Experienced users will appreciate the efficiency and versatility of the 
Visual Shell. The distinction is very much akin to the difference between a line- 
oriented text editor and a fitll — screen editor. 

A menu shell can be used effectively with very little study. On the other hand, a menu 
sheU can also restrict the user from using the operating system in creative, possibly 
more efficient ways. The Microsoft Visual Shell strikes a balance in this regard. The 
Visual Shell is designed to do allofthe things that the coaunand-Iine^ellscando. 

11.2 Getting Started with the Visual Shell 

This section describes how to enter, obtain help about, and leave the visual shell. This 
section also describes what you will see on the screen wliile running the visual shell and 
how the menus work. 

Note the followii^ convention for specifying keystrokes. CTRL refers to the CTRL 
sbiftkey. CTRL-CmeanspressingtheCrRLand'c'keysatthesametime. ALTrefCTs 
to the ALT shift key. ALT-H means pressing the ALT and 'H' keys at the same time. 
Note the irrelevance of case inentering Menu Selection diaracters. For instance, press 
either 'Q* or ' q* torun the "Quit" command fitom the mainmenu . 

11.2.1 Entering the Visual SheU 
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Log in to XENIX If you are not sure how to log in, consult the Operations Guide or 
have someone knowlegeable about XENIX help you. When you have a stiell prompt 
(typically '$' or *%*), the operating system is waiting for a comniani. Enter die 
command: 

vsh 

and pressRETURN. 

11.2.2 Getting Hdp 

if at anytime you are not sure what to do, either run the "He^" Menu Selection or 
press ALT-H. Refer to the rcfereiKe section of this chapter for information about the 
He^command. 

1 1.2.3 Leaving the Visual Shdl 

To exit the Visual Shell select the Quit command fiom the main menu. The simplest 
way to do this is to simply pns$ 'q' or *Q'. in response to the prompt "Type Y to 
confirm", enter 'y' or ' Y\ if you don't want toexit the Visual SheU yet (perhaps you 
pressed 'q' by mistalte), enter any other diaracter but *y* or ' Y* . if you have invdied 
the visual shell from another sheU, as described above, you will need to log out from 
XENIX by entering CTRL-D or 'logout* and pressing RETURN, if the Visual Shell is 
your default shell.youwUlautomatically be logged out. 

11.3 The Visual SheU Screen 



U.3.1 Status Line 

The bottom line on the screen is called the 'status line*. The status line displays the 
name of the current working directory, notifies you if you have mail, and gives the 
date, time and the name <^the operating system. 

1U.2 Message Line 

The line above the 'status line' is called the 'message line* . The message line di^lays 
special output from XENIX comnmnds. suchasenrorrepcvts. 

11.33 Main Menu 

The next section of the screen above the message line is the 'main menu*. The main 
menudisplaysaselectionofusefiil XENIX commands. 

The currently selected menu command b highlighted on the screen. To select any 
command, press the SPACE BAR. The next highlighted command is selected. The 
BACKSPACE key will oaove to the previous command. Move throu^ the menu until 
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you ha ve found the coouiuumI you warn . To run the cun^cnUy selected coaunand . press 
RETURN. 

You may also enter the first letter of a command to select that coomiand. if you enter 
the first letter of (he command . you do not need topress RETURN . 

If you enter a letter which does not correspond to a mem selection, the message 

Not a valid option 

will be displayed. TiyaiK>theroption. 

11^.4 Command Optioa Mcmi 

When you have selected a command, the main menu will be replaced with a command 
option menu . The comnund option menu gives the options available with the specific 
command. YoumustfiUintheoptionswithappropriateresponses. 

If you wish to return to the main menu without rtmning the command, press CTRL -C. 
(cancel). If you wast torunthe command withtheselectedoptions|we8sRETURN. 

The following keystrokes allow editing of optkmresponses. 

CTRL-I.cnu.--A, or 'tab* Movetonextfieldinoptionsmenu. 

CFRL-YorDEL Delete charaacr under cursor. 

CTRL-L Movecursortocharactertorightofcurrentposition 

in current optionfield. 
CTRL-K Movecursortocharactertoleikofcunentpositioa 

in current optionfield. 
CTRL-P MovecUrsortowordincurrentfieldtorightofthe 

current word. 
CTRL-O Movecursortowordincurrentfieldtoleftofthe 

current word. 



1 1^.5 Program On^t 

While running a command, conomands given and ou^t (unless redirected) will be 
displayed above the menu and below the view window . The output scrolls up: moves 
firom bottom to top. Linesscrollingoffthetopoftheouqmt window disappear. 

Visual Shell command lines are listed with each argument preceded by the number in 
the argument list enclosed in parentheses. The command b named in the output 
window by the menu command. Hence, if you run the coootmand /Un/b with the 
argument - R , the output window wiU display the command line as folio ws: 

Run (1) /bin/Is (2) -R 

To change the command line format to reflect the actual XENIX conamand line 
generated by the Visual Shell, use the Options Ou^Mit menu command. 

11.3.6 View Window 

A menu (tf currently accessible files and directories can be displayed at the top of the 

11-3 



XENIX Operations Guide 



screen in alphabetical order, left to right, top to bottom. Note that this display is the 
same as that obtained using the view conunand. This will be referred to as the 'view 
window' in this chapter. If thedirectory list is larger thanthecurrent window size. you 
may scroll through using the key commands given below. To reset the window size, 
usethe 'Window* mainmenucooimand. 

The currently selecteditemishighlightedintheviewwindow. Use the arrow keys ami 
other key commands given at the end of this section to move the highlight around the 
window. 

If a directory is being listed, subdirectories are ^own enclosed in square brackets. To 
view a subdirectory, {vess '=* v/idle the directory is highlighted. To return to the 
fveviousdirectory after viewing a subdirectory, press '—*. The parent directory of the 
current directoryisshownas '[..]*. The current directory is shownas *[.]*. ExecutaUe 
files are |»ieceded by an asterisk. The last ooodification date of the currently selected 
item is given at the right margin of the last line of the window. The name of the item in 
view in thecuiient window is givenin the upper right —hand comer of the window. 

The view window may also display contents of files. Highlight a file, and press *=\ 
You may scroll throu^ the file using the kqr commands given bebw. While viewing 
a file, the highlighted area coversone line. 

If you press * » * whileanexecutabk file is highlighted, that file willbe run. 

If the Visual Shell requires a fife or directory name, the currently selected View 
WiiKfew item can be automaticaUy entered in the relcvem option field by pressing any 
direaional aaovement key following selection of the command. This method saves 
keystrokes and reduces the chance of making typing mistakes. On the other hand, if 
you wish to explicitly enter a file or directory in an option fieU, type in the tume after 
seleaingthecommand. 

U se thesekeystrokesto select files from the view window: 

WINDOW MOTION KEYS 
CTRL-Q Movetostait(firstitemali4iabetically)ofviewwindow. 

CTRL-Z Movetoeiid(lastitemalphabetically)ofviewwindow. 

CTRL-RCTRL-E Scroll view window up. 
CTRL-RCTRL-S Scroll view window down. 
s= Viewindicated^m,eitherfileordirectoiy. 

If tx> view window bpresent, thecurrent woridng directory 

is displayed. 
— Return windowdisplaytoparentdiiectory of 

cuneotly listeddirectory . 

If viewing a file, exit from vie wing that fife. 

Last new window isretumed to. 
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DIRECTION AL MOVEMENT KEYS 
ARROWUPorCTRL-E: Move highhght up in view window. 

ARROWDOWNorCTRL-X: Movehighlightdowniii view window. 
ARROW LEFT orCTRL -S: Move highlight left in view window. 
ARROWRIGhTTOTCTRL-D: Movehighlighlrightin view window. 

Moventcni beyond the left or right nuu-gin will proceed to the next item on the previous 
or next line unless at the edge of the view window. Movement beyond the top or 
bottom edge of the current window will scroll the view window up or down if there are 
more items in that direction in the view window. 

Note that there are two ways to move thehighlight around. Eitheruse the keypad arrow 
keysorthechisterof four keyson the far leftof the keyboard 'e\ 'x', *s\ and 'd' lifted 
with CTRL. 

While viewing a file, the direct ional movement keys for up and left nx>ve the highlight 
up , and the key s for down and right move the highli^ted line down. 

11.4 Visual Shell Reference 



1 1.4. 1 Vkual SheD Defanlt Mem 

This section describes the default Visual Shell mem ccnomands and options. The 
menu options arc displayed at the bottomof the screen above the status line. 

To invoke a command, move the highlight fcn^vards through the main menu uang the 
space bar or the tab key, or backwards using the backspace key. Or amply press the 
first letter ofthe command. 

Most commands require entering options. Move the cursor to the field using the 
SPACE BAR. TAB key or BACKSPACE key. and type your response. To edit the 
options, refer to the key cnnmands listed above in the section in this chaptor labelled 
"Command Option Menu". To selea an item fipom a View Window listing for 
insertion in a field, refer to the section in this chapter labelled " View Window " . 

Note that some options have 'switches* with predefined (default) selections. The 
currently selected switch setting is higlilighted. The default is the parenthesized 
setting. Forinstance. in the switch: 

Recursive: <yes) no 

the default is recursive . To diange a switch, select the field and press the SPACE BAR 
orBACKSPACE. 

Copy 

The Copy command can copy files and directories. To copy a file, select "File" from 
the options, to copy a directory, select * 'Directcvy ". A sub— menu will appear. Enter 
the file or directory you wish copied in the from: field. Enter the file or directcxy you 
wish copied tothe to: field. Note that if the item in the to: field already exists, it will be 
overwritten, so be careful. 

The Copy Directory sub— menu has a switdi "recursive". If this switch is set to yes, 
all sub- directories and their contents below the specified directory will be copied. 
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Ddete 

The Delete command can remove files and directories, in the DELETEramc: field 
enter the name of the file or directory you want to remove. Note that once the file or 
directory is deleted, the contents are gone forever unless you have another c(^y . so be 
careful. 

Edit 

The Edit command invokes the full- screen editor vi. Hie current directoiy will be 
displayed in the output window. Enter in the option field EDITJUenamt: the name of 
the fileyou wish toedtt using vi. 

To learn vi, consult the document " vi: a Screen Editor" in the XEhOX User'sCuide , 
and the vi(Q manual page in the XENIX Reference. A vi reference card u also 
availabfe. 

Help 

The Help command (also available by pressing ALT-H at any time), can give on-line 
help regarding mai^ aspects of Visual Shell use. The view window will display the 
help file. Use the menu to select the topic you need help with. For instance, move the 
hi^light to 'Keyboard' using the SPACE BAR and press RETURN to view the help file 
starting at the 'Keyboard* section. The 'Next* and 'Previous* fields in the menu will 
scroll through the the he^ file fitm the present location one screen at a time. Your 
work will remain undisturbed. To return from Help, press CTRL-C or select the 
'Resume'menuoptioiL 

Mafl 

The Mail command enters the XENIX mail system. There are two options: "Send" 
and ' 'Read ' * For mare information about mail, refer to the section of the XENIX Users 
Guide titled ' 'Mail' ' or refertothe maB(Qmanualpage. 

Name 

The Name command renames an existing file or directory . There are two fields. From: 
and To:. Enter the name of the file or directoiy you want to rename inFrom: and the 
new name in7o.' 



11.4.2 Optioiis 

The Options MainMenu Selection provides four sub-menus. These sub-menus run 
commands which typically are used infrequently orwhichhaveirrevocableresults. 

Directory Optioa 

The Directoiy command has two sub— menus. Make and U sage. 

Make Directory Optioo This cunmand creates a new directoiy named what you 
enter in the /lame; fieU. 

UsageDfarectory Optkm Counts the numberofdidcbk)cksinthe directories specified 
inthe/Kim«.-fiekl. The format is the same as the XENIX command b-s. Refer to the 
manual pagekKQ. 
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FilcSystcm Option 



FileSystem has the five sub— nienus: Create, FilesCheck, SpaceFree. Mount and 
Unmount. 

CrtBte FfleSystem Option Create FileSystem makes a XENIX filesystem. The 
Create command performs radical system maintenance and may have incvocable 
effects. CareisadvisedwhenusingOreateFileSystem. 

The fiinaionality is the same as mkfs(Q. Consult the mkfs(Q manual page before 
running Create FileSystem. Create FileSystem will prompt you for device, block size, 
gap number and blodc number. Refer to tbe XENIX Operations Guide diapter on 
"Using File Systons". The section "Qeating a File System" also explains this 
command. 

FilcsCbeck FilcSystcm Option FilesCheck checks the consistency of a XENIX 
filesystem and attempts repair if damage is detected. The FilesCheck command 
performs radical system maintenance and may have irrevocable effects. Care is 
advised whenusingFilesCheck. 

The functionality is the same as fsck(C). Cbnsuh the fsck(Q manual page before 
runningFilesCheck. FilesCheck will i«ompt you forthe device to dieck. 

OutpotOplion 

The Output Option command has one switch, commands tike: VShelt XENIX" . The 
default is VShell. IF VShell is set. the vsb form of commands given appear in the 
upward scrolling output window. If XENIX is q>ecified, the XENIX coounand line 
which vsh generated will be shown instead. 

FcrmissioiisOpdoii 

The Permissions Option conomand allows changing the access pennissions on files 
and directories. The funaionalityisthe same asthecluiiod(Q command. Consult the 
chmod manual page if you do not undcrsund the concept of XENIX pennissions. 

In the name: field entCT the name of the file or directory you wish to alter the 
permissions on. You may only alter the pennissions on files and directories you own. 
There are four switches, who:, read: , write: .Kodexecute: . 

The who: switch has four scnings. All , Me , Group and Others . A// is the default. Ml 
refers to yourself, those with the same group id as yourself and others. Me refers to 
yourself. GrouprefersandallothCTswithyourgroupid. 0//iersreferstothoseoutside 
your group. 

The read . write and execute switches have two settings , yes and no. The default is yes 
fotMe, and no for Grou/i and 0//ter5. Thisgrantsthegiventypeofpermissiontothose 
specified in the who: switch . No takes away the given type of permission firom those 
specified in the who: switch. 

11.4.3 Print 



The Print conmiand puts a file or files in the queue for your lineprinter. in ihc filename: 
option fie Id, enter the file n-filesyouwanttoprint. 
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11.4.4 Quit 

The Quit command exits the Visual Shell. The only option is Enter Y to confirm: . 
Enter 'Y'or'y'ifyourcallywanttoquit. Anyotherkeycanccbihequit. 

11.4.5 Run 

The Run command executes a program or shell script. The name: option takes the 
name of an executable file. In the parameters: option field enter flags to pass to the 
executable file. The output: <^oa can specify a file to redirect output to or another 
program to send the output to. Enta a vertical bar Tin the output field to use the pipe 
menu. 

It is also possible to run an executaUe file by highlighting the name of the file in the 
View Window and pressing '=' . 

11.4.6 View 

The View command allows you to inq)ect without altering the contents of files and 
directories. View is also available at any time for an item highlighted in the View 
Window by pressing '=*. See the section above labelled 'View Window* for the 
details of using View. 

To alter the height and diaracteristics of the View Window, use the 'Window* menu 
option. Seethe 8ectionbeiowlabelled"Window". 

If you have imckcd View from the menu, enter the name of the file or directory you 
wish to view in the V/£Wname; field, or select firam a directory view window. 

To return from any View action to the previously displayed View Window, press the 
minus key '->*. 

If you View a oon-executable binary file, non-ascii diaracters are dis|dayed as the 
character'®*. 



11.4.7 Window 

The Window command alters the height and redraw diaracteristics of the Visual Shell 
View Window. 

The 

WINDOW redraw: Yes (No) 

switchtumsonoroffredrawoftheview window afterrunniitgacommand. 

The height'mlines: field changes the number of lines displayed in the view window. 
The minimum window hei^t is 1 lines. The default window height u 5 lines. The 
maximum window heij^ is 1 S lines. 
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11.4.8 Pipes 



XENIX allows output from one program to be passed to another program or to be put in 
afile. This is callod 'piping' or 'pipelining'. Ifthcoutputisplacedinafileitissakitobc 
'redirected' . Piping is supported in the Visual Shellthrough the pipe menu. 

The Pipe menu is invoked by entering a vertical bar 'I* charaaer in any option field 
named output: . For instance, the Run main menu and the Pipe menu itself have an 
(Mtput: field. The available Pipe menu oxnmands are Count, Get, Head, More , Run, 
SortandTail. Each Pipe menu sub— command also has an ou/pu/: field, wfaidt allows 
construction of pipelines of aifoitraiy length. 

11.4.9 Count 



Count counts words, lines and characters in the input pipe. The default is all of the 
above . There is a switch for each type of item to count . Tlie Count Pipe Menu option 
corresponds to the XENIX command wc. Consult the manual page wc(C) for the 
fimctionality. 

11.4.10 Get 

Get looks for patterns in the input pipe. The pattern may be verbatim, or you may 
spcciiy a "regular expression" to look for. Regular expressions may coitain 
'wildcard' diaractcrs which represent sets of strings. Consult the manual page 
grep(C) for the available wildcard characters. 

The first Get switdi is Unmatched (Yes) No . If you specify Yes (the default), all lines 
containing the given pattern wiU be output. If Unmatched is set to off. all lines not 
containingthe givenpattem will be output. 

The second Get switch is ignore case: wfaidi supfMVSses the case while loduQg for the 
regular expression. The default isoff. 

The third Get switch is tine numbers: , which reports the line in the input stream which 
the regular expression was matched on. Tbe default b oo. 

11.4.11 Head 

Head iMfints a specified number of lines of the input stream starting from the first line. 
The tines: field may be set to specify the number of lines at the head of the input stream 
toprint. ThedefauhisS lines. 

The Head Pipe Menu (^tion corresponds to the XENIX command head. Consult the 
manual page head(Q for the functionality. 

11.4.12 Moi« 

Moreallowsviewing an input streamone screenatatime. The More Pipe Menu option 
invokes the XENIX command more. Consult the manual page more(C) for the 
fimctionality. 
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11.4.13 Run 

The Run Pipe Menu option allows the speciScation of any command not in the Pipe 
menu. The functionality isthe same as the VisualShellMainMenu Option "Run". 

11.4.14 Sort 

The XENIX son utility can be invc^d through the Son Pipe menu option. The input 
stream is soned. 

The first Son switch is on/tfr.-o. Select '>*,thedefauh,tosoninascending order. 
Select *<* to son indescending order. 

The second Son switdi suppresses the case of characters inthe son. The defauk isoff. 

The third Son switch sons the input streamassuming an initial numeric field inthe input 
stream. If this switch is off. initial numbers will be soned in asdi order, which means 
that a line beginning with '10* will be output befoie the line beginning with *2\ The 
default isoff. 

The founh Son switdi sonsthe input stream in dictionaiyorder.rather than ascii order. 

The Son Pipe Menu option corresponds to the XENIX command son. Consult the 
manual page sorKQfor the functionality. 

11.4.15 Tal 

Tail prints a specified number of lines of thd input stream up to the end of the stream. 
The tines: field may be set to specify the number of lines to print. The defauh is 1 S 
lines. 

The Tail Pipe Menu option conesponds to the XENIX command tail. Consult the 
manual page tal(Q for the functionality. 
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A.1 Introduction 



Ed is a text editor used to create and modify text. The text is normally a 
document, a program, or data for a program, thus e if is a truly general pur pose 
program. Note that the line editor e«, available with other XENIX packages is 
very similar to ed, and therefore this chapter can be used as an introduction to 
e» as well as to e^. 



A.2 Demonstration 

This section leads you through a simple session with td, giving you a feel for 
how it is used and how it works. To begin the demonstration, invoke ed by 
typing: 

ed 

This invokes the editor and begins your editing session. An asterisk "**' 
prompts for commands to be entered. Initially , you are editing a temporary file 
that you can later copy to any file that you name. This temporary file is called 
the "editing buffer," because it acts as a buffer between the text you enter and 
the file that you will eventually write out your changes to. Typically, the first 
thing you will want to do with an empty buffer is add text to it. For example, 
after the prompt, type: 

a 

this is line 1 

this is line 2 

this is line 3 

this is line 4 

CNTRL-D 

This "appends*' four lines of text to the buffer. To view these lines on your 
screen, type, 

l,4p 

where the "1,4" specifies a line number range and the p command "prints" the 
specified lines on the screen. 

Now type 

2p 
to view line number two. Next type just 

P 
This prints out the current line on the screen, which happens to be line number 
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two. By default, most e if commands operate on only the current line. 

A.3 Basic Concepts 

This section illustrates some of the basic concepts that you need to understand 
to effectively use ei. 



A.3.1 The Editing Buffer 

Each time you invoke ed,Kn area in the memory of the computer is allocated on 
which you will perform all of your editing operations. This area is called the 
"editing buffer". When you edit a file, the file is copied into this bufTer where 
you will work on the copy of the original file. Only when you write out your file 
do you affect the original copy of the file. 



A.3. 2 Commands 

Commands are entered by typing them at your keyboard. Like normal XENDC 
commands, entry of a command is ended by typing a NEWLINE. After you type 
NEWLINE the command is carried out. In the following examples, we will 
presume that entry of each command is completed by typing a NEWLINE, 
although this will not be explicitly shown in our examples. Most commands are 
single characters that can be preceded by the specification of a line number or a 
line number range. By default, most commands operate on the "current line", 
described below in the section on "Line Numbers". Many commands take 
filename or string arguments that are used by the command when it is 
executed. 



A.3.3 Line Numbers 

Any time you execute a command that changes the number of lines in the 
editing buffer, ed immediately renumbers the lines. At all times, every line in 
the editing buffer has a line number. Many editing commands will take either 
single line numbers or line number ranges as prefixing arguments. These 
arguments will normally specify the actual lines in the editing buffer that are to 
be affected by the given command. By default, a special line number called 
"dot" specifies the current line. 



A.4 Tasks 

This section discusses the tasks you perform in everyday editing. Frequently 
used and essential tasks are discussed near the beginning of this section. 
Seldom- used and special-purpose commands are discussed later. 
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A.4.1 Entering and Exiting The Editor 
The simplest w&y to invoke erfisto type: 

ed 
The most common way, however, is to type: 

ed filename 
where filename is the name of a new or existing file. 
To exit the editor, all you need to do is type: 

q 

If you have not yet written out the changesyou have made to your file, e Jwarns 
you that you will lose these changes by printing the message: 



If you still want to quit, type another q. In most cases you will want to exit by 
typing: 

w 

q 

so that you first write out your changes and only (Aen exit the editor. 



A.4.2 Appending Text: a 

Suppose that you want to create some text starting from scratch. This section 
shows you how to put text in a file, just to get started. Later we'll talk about 
how to change it. 

When you first invoke ed, it is like working with a blank piece of paper — there 
is no text or information present. These must be supplied by the person using 
ed, usually by typing in the text, or by reading it in from a file. We will start by 
typing in some text and discuss how to read files later. 

In ed terminology, the text being worked on is said to be "kept in a buffer". 
Think of the buffer as a workspace, or simply as a place where the information 
that you are going to be editing is kept. In effect, the buffer is the piece of paper 
on which you will write things, make changes, and finally file away. 

You tell erfwhat to do to your text by typing instructions called "commands". 
Most commands consist of a single letter, each typed on a separate line. Ed 
prompts with an asterisk (*), This prompting can be turned on and off with the 
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prompt command, P. 

The first command we will discuss is append (a) written as the letter "a" on a 
line by itself. It means "append (or add) text lines to the buffer, as they are 
typed in." Appending is like writing new material on a piece of paper. 

To enter lines of text into the buffer, just type an "a", followed by a RETURN, 
followed by the lines of text you want, like this: 



Now is the time 
for all good men 
to come to the aid of their party. 



To stop appending, type a line that contains only a period. The period ( . ) telb 
ed that you have finished appending. (You can also use CNTRL-D, but we will 
use the period throughout this discussion.) If eiseems to be ignoringyou, type 
an extra line with just a period (.)<>" >^' You may find youVe added some 
garbage lines to your text, which you will have to take out later. 

After appending is completed, the buffer contains the following three lines: 

Now is the time 
for all good men 
to come to the aid of their party. 

The a and . aren't there, because they are not text. 

To add more text to what you already have, type another a command and 
continue typingyour text. 

If you make an error in the commands you type to ed, it will tell you by 
displaying the message: 

error meteage 



A.4.3 Writing Out a File: w 

You will probably want to save your text for later use. To write out the 
contents of the buffer into a file, use the write (w) command followed by the 
name of the file that you want to write to. This copies the contents of the buffer 
to the specified file, destroying any previous contents of the file. For example, 
to save the text in a file named text, type: 

w text 
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Leave a space between w and the filename. Ed responds by printing the 

number of characters it has written out. For instance, e (/might respond with 

68 

(Remember that blanks and the newline character at the end of each line are 
included in the character count.) Writing out a file just makes a copy of the 
text — the buffer's contents are not disturbed, so you can go on adding text to it. 
If you invoked ed with the command "ed filename", then by default a w 
command by itself will write the bufTer out to Rename. 

This is an important point. Ed at all times works on a copy of a file, not the file 
itself. No change in the contents of a file takes place until you give a w 
command. Writing out the text to a file from time to time as it is being created 
is a good idea. If the system crashes or if you make some horrible mistake, you 
will lose all the text in the buffer, but any text that was written out to a file is 
relatively safe. 



AAA Leaving The Editor: q 

To terminate a session with ed, save the text you're working on by writing it to 
a file using the w command, then type: 



The system responds with the XE3^IX prompt character. If you try to quit 
without writing out the file e d will print 



At that point, write out the text if you want to save it; if not, typing another 
"q" will get you out of the editor. 



Exercise 

Enter erf and create some text by typing: 

a 

... text ... 

Write it out by typing: 

w filename 
Then leave edhy typing: 
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Next, use the cat command to display the file on your terminal screen to see 
that everything has worked. 



A.4.5 Editing A New File: e 

A common way to get text into your editing buffer is to read it in from a file. 
This is what you do to edit text that you have saved with the w command in a 
previous session. The edit ( e) command places the entire contents of a file in 
the buffer. If you had saved the three lines "Now b the time", etc., with a w 
command in an earlier session, the etf command 

e text 

would place the entire contents of the file text into the buffer and respond with 

68 

which is the number of characters in text. If anything ii already in the buffer, it 
i$ deleted fir at. 

If you use the e command to read a file into the buffer, then you don't need to 
use a filename after a subsequent w command. £^ remembers the last filename 
used in an e command, and w will write to this file. Thus, a good way to operate 
is this: 

ed 

e file 

[editing 9e$non\ 

w 

q 

This way , you can type w from time to time and be secure in the knowledge that 
if you typed the filename right in the beginning, you are writing out to the 
proper file each time. 

A.4.6 Changing the File to Write Out to: f 

You can find out the last file written to at any time using the file (f) command. 
Just type f without a filename. You can also change the name of the 
remembered filename with f. Thus a useful sequence is 

ed precious 
f junk 

which gets a copy of the file named preeiou$, then uses f to save the text in the 
file junk. The original file will be preserved as preeiou§. 
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A.4.7 Reading in a File: r 

Sometimes you want to read a file into the buffer without destroying what is 
already there. This function is useful for combining files. This is done with the 
read (r) command. The command 

r text 

reads the file text into your editing buffer and adds it to the end of whatever is 
already in the buffer. For example, pretend that you have performed a read 
after an edit: 

e text 
r text 

The buffer now contains two copies of text (i.e., six lines): 

Now b the time 

for all good men 

to come to the aid of their party. 

Now is the time 

for all good men 

to come to the aid of their party. 

Like the w and e commands, after the reading operation is complete r prints 
the number of characters read in. 



Exercise 

Experiment with the e command by reading and printing various files. You 
may get the error message 

^name 

cannot open input file 

where name is the name of a nonexistent file. This means that the file doesn't 
exist, typically because you spelled the filename wrong, or perhaps because you 
do not have permission to read from or write to that file. Try alternately 
reading and appending to see how they work. Verify that the command 

ed file.text 

is equivalent to 

ed 

e file.text 
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A.4.8 Displaying Lines On The Screen: p 

Use the "print"( p) command to print the contents of the editing buffer (or 
parts of it) on the terminal screen. Specify the lines where you want printing to 
begin and where you want it to end, separated by a comma and followed by the 
letter "p". Thus, to print the first two lines of the buffer (that is, lines 1 through 
2) type: 

l,2p 

£</ responds with: 

Now is the time 
for all good men 

Suppose you want to print <Ul the lines in the bufTer. You could use "l,3p" as 
above if you knew there were exactly 3 lines in the buffer. But you will rarely 
know how many lines there are, so ed provides a shorthand symbol for the line 
number of the last line in the buffer — the dollar sign ($). Use it this way: 

This will print a// the lines in the buffer (from line 1 to the last line). If you want 
to stop the printing before it is finished, press the INTERRUPT key. Ed then 
displays 

t 
interrupt 

and waits for the next command. 

To print the /a«Mine of the bufTer, use: 

tp 
You can print any single line by typing the line number, followed by a p. Thus 

Ip 

produces the response 

Now is the time 

which is the first line of the buffer. 

In fact, ed lets you abbreviate even further: you can print any single line by 
ty ping;u«t the line number; there's no need to type the letter p. If you type 
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I 

edpunis the last line of the buffer. 
You can also use $ in combinations like 

which prints the last two lines of the buffer. This helps when you want to see 
how far you are in your typing. 

The next step is to use address arithmetic to combine the line numbers like dot 
(.) and dollar sign ($) with plus (+) and minus (-). (Note that "dot" is 
shorthand for the current line, and is discussed in a later section.) Thus 

$-1 

prints the next to last line of the current file (that is, one line before the line $). 
For example, to recall how far you were in a previous editing session 

$-5,$p 

prints the last six lines. (Be sure you understand why it's six, not five.) If there 
aren't six lines in the file, you'll get an error message. 

The command 

.-3,.+3p 

prints from three lines before the current line (line dot) to three lines after. The 
plus (+) can be omitted: 

.-3,.3p 

is identical in meaning. 

Another area in which you can save typing effort in specifying lines is to use plus 
and minus as line numbers by themselves. For example 



by itself is a command to move back one line in the file. In fact, you can string 
several minus signs together to move back that many lines. For example 



moves back three lines, as does 
-3 
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Thus 

-3,+3p 
is also identical to 

?.-3p+3p 

A. 4.0 Displaying The Current Line: dot (.) 

Suppose your editing buffer still contains the following six lines: 

Now is the time 

for all good men 

to come to the aid of their party. 

Now is the time 

for all good men 

to come to the aid of their party. 

If you type 

l,3p 

etf displays 

Now is the time 
for all good men 
to come to the aid of their party. 

Try typing: 



This prints 

to come to the aid of their party. 

which is the third line of the buffer. In fact, it is the last (most recent) line that 
you have done anything with. You can repeat this p command without line 
numbers, and ed-w'iW continue to print line 3. 

This happens because ed maintains a record of the last line that you did 
anything to (in this case^ line 3, which you just printed) so that it can be used 
instead of an explicit line number. The line most recently acted on is referred to 
with a period ( . ) and is called "dot". Dot is a line number in the same way that 
dollar ($) is; it means "the current line", or loosely, "the line you most recently 
did something to". You can use it in several ways. One possibility is to type: 
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mSp 

This wili print all the lines from (and including) the current line clear to the end 
of the buffer. In our example these are lines 3 through 6. 

Some commands change the value of dot, while others do not. The p command 
sets dot to the number of the last line printed. In the example above, p sets dot 
to 6. 

Dot is often used in combinations like this one: 

.+ 1 
Or equivalently: 

.+ lp 

This means "print the next line" and is one way of stepping slowly through the 
editing buffer. You can also type 

.-1 

This means "print the line before the current line". This enables you to go 
backwards through the file if you wish. Another useful command is something 
like 

.-3,.-lp 

which prints the previous three lines. 

Don'tforget that all ofthe$e change the vtUtie of dot. You can find out what dot 
is at any time by typing: 



Ed responds by printing the value of dot. Essentially, p can be preceded by 
zero, one, or two line numbers. Ifno line number is given, crfprints the "current 
line", the line that dot refers to. If one line number is given (with or without the 
letter p), erf prints that line (and dot is set there); and if two line numbers are 
given, erfprints all the lines in that range (and sets dot to the last line printed). 
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If two line numbers are specified, the first cannot be bigger than the second. 
Pressing RETURN once causes printing of the next line. It is equivalent to: 

.+ lp 
Try it. Next, try typing a minus sign ( - ) by itself; it is equivalent to typing 

Exercise 

Create some text using the a command and experiment with the p command. 
You will find, for example, that you can't print line or aline beyond the end of 
the buffer, and that attempts to print lines in reverse order using "3,lp" do not 
work. 

A. 4. 10 Deleting Lines: d 

Suppose you want to get rid of the three extra lines in the buffer. Use the delete 
(d) command. Its action is similar to that of p, except that d deletes lines 
instead of printing them. The lines to be deleted are specified for d exactly as 
they are for p. Thus, the command 

4,$d 

deletes lines 4 through the end. There are now three lines left in our example, as 
you can check by typing: 

Notice that $ now is line 3! Dot is set to the next line after the last line deleted, 
unless the last line deleted is the last line in the buffer. In that case, dot is set to 
$. 

Exercise 

Experiment with the a, e, r, w, p, and d commands until you are sure that you 
know what they do, and until you understand how dot ( . ), dollar ($), and line 
numbers are used. . 

Try using line numbers with a, r, and w, as well. You will find that a appends 
lines after the line number that you specify (rather than after dot); that r reads 
in a file after the line number you specify (not necessarily at the end of the 
buffer); and that w writes out exactly the lines you specify, not the whole buffer. 
These variations are sometimes useful. For instance, you can insert a file at the 
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beginning of a buffer by typing 

Or filename 
and you can enter lines at the beginning of the buffer by typing: 

Oa 

[tnpuf text here] 

Notice that typing 

.w 
is very different from typing 



since the former writes out only a single line and the latter writes out the whole 
file. 



A. 4. 11 Performing Text Substitutions: s 

One of the most important c ^commands is the substitute (s) command. This is 
the command that is used to change individual words or letters within a line or 
group of lines. It is the command used to correct spelling mistakes and typing 
errors. 

Suppose that, due to a typing error, line 1 says: 

Now is th time 

The letter 'VhasbeenleftofTof the word "the". You can uses to fix this up as 
follows: 

Is/th/the/ 

This substitutes for the characters "th", the characters "the", in line 1. To 
verify that the substitution has worked, type 

P 

to get 

Now is the time 

which is what you wanted. Notice that dot must be the line where the 
substitution took place, since the p command printed that line. Dot is always 
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set this way with the s command. 

The syntax for the substitute command follows: 

[$tatiing-line,ending-line]s/ pattern/ replacement/ emd$ 

Whatever string of characters is between the first pair of slashes is replaced by 
whatever is between the second pair, in all the lines between $tarting-line and 
ending-line. Only the first occurrence on each line is changed, however. 
Changing crcry occurrence is discussed later in this section. The rules for line 
numbers are the same as those for p, except that dot is set to the last line 
changed. (If no substitution takes place, dot is not changed. This causes 
printing of the error message: 

f 

search string not found 

Thus, you can type 

1 ,$s/speling/spelling/ 

and correct the first spelling mistake on each line in the text. 

If no line numbers are given, the s command assumes we mean "make the 
substitution on line dot", so it changes things only on the current line. This 
leads to the very common sequence 

s/something/something else/p 

which makes a correction on the current line, then prints it to make sure the 
correction worked out right. If it didn't, you can try again. (Notice that the p is 
on the same line as the s command. With few exceptions, p can follow any 
command; no other multicommand lines are legal.) 

It is also legal to type 

s/string// 

which means "change the first string of characters to nothing" or, in other 
words, remove them. This is useful for deleting extra words in a line or 
removing extra letters from words. For instance, if you had 

Nowxx is the time 
you could type 

s/xx//p 
to get 
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Now is the time 

Notice that two adjacent slashes mean "no characters", not a space. There »»a 
difference. 



Exercise 

Experiment with the substitute command. See what happens if you substitute 
a word on a line with several occurrences of that word. For example, type: 

a 

the other side of the coin 

s/the/on the/p 

This results in: 

on the other side of the coin 

A substitute command changes only the first occurrence of the first string. You 
can change all occurrences by adding a g (for "global") to the s command, like 
this: 

s/.../.../g 

Try using characters other than slashes to delimit the two sets of characters in 
the s command — anything should work except spaces or tabs. 



A. 4. 12 Searching 

Now that you've mastered the substitute command, you can move on to 
mastering another important concept: context searching. 

Suppose you have the original three-line text in the buffer: 

Now is the time 
for all good men 
to come to the aid of their party. 

Suppose you want to find the line that contains the word "their", so that you 
can change it to the word "the". With only three lines in the buffer, it's pretty 
easy to keep track of which line the word "their" is on. But if the buffer 
contained several hundred Hnes, and you'd been making changes, deleting and 
rearranging lines, and so on, you would no longer really know what this line 
number would be. Context searching is simply a method of specifying the 
desired line, regardless of its number, by specifying a textual pattern contained 
in the line. 
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The way to say "search for a line that contains this particular string of 
characters" is to type: 

/string of characters we want to find/ 

For example, the e<f command 

/their/ 

is a context search sufficient to find the desired line — it will locate the next 
occurrence of the characters between the slashes (i.e., "their"). Note that you 
do not need to type the final slash. The above search command is the same as 
typing: 

/their 

The search command sets dot to the line on which the pattern is found and 
prints it for verification: 

to come to the aid of their party. 

"Next occurrence" means that erf starts looking for the string at line ".+1", 
searches to the end of the buffer, then continues at line 1 and searches to line 
dot. (That is, the search "wraps around" from $ to 1.) It scans all the lines in the 
buffer until it either finds the desired line or gets back to dot. If the given string 
of characters can't be found in any line, e <f prints the error message: 

search string not found 

Otherwise, erf prints the line it found. You can also search backward$ in a file 
for search strings by using question marks instead of slashes. For example 

Tthing? 

searches backwards in the file for the word "thing" as does 

?thing 

This is especially handy when you realize that the string you want is backwards 
from the current line. 

The slash and question mark are the only characters you can use to delimit a 
context search, though you can use any character in a substitute command. If 
you get unexpected results using any of the characters 

- . I I . \ & 

read Section A.5, "Context and Regular Expressions". 
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You can do both the search for the desired line an^ a substitution at the same 
time, like this: 

/their /s/their/the/p 

Thisyields: 

to come to the aid of the party. 

The above command contains three separate actions. The first b a context 
search for the desired hne, the second is the substitution, and the third is the 
printing of the line. 

The expression "/their/" is a context search expression. In their simplest form, 
all context search expressions are like this — a string of characters surrounded 
by slashes. Context searches are interchangeable with line numbers, so they 
can be used by themselves to find and print a desired line, or as line numbers for 
some other command, like s. They were used both ways in the previous 
examples. 

Suppose the buffer contains the three familiar lines 

Now is the time 
for all good men 
to come to the aid of their party. 

The edline numbers 

/Now/+l 

/good/ 

/party/-l 

are all context search expressions, and they ^1 refer to the same line (line 2). To 
make a change in line 2, you could type 

/Now/+ Is/good/bad/ 

/good/s/good/bad/ 
or 

/party /-Is/good/bad/ 



or 



A- 17 



XENIX User's Guide 

The choice is dictated only by convenience. For instance, you could print all 
three lines by typing 

/Now/,/party/p 

or 

/Now/,/Now/+2p 

or any similar combination. The first combination is better if you don't know 
how many lines are involved. 

The basic rule is that a context search expression is the same as a line number, 
so it can be used wherever a line number is needed. 

Suppose you search for 

/horrible thing/ 

and when the line is printed you discover that it isn't the "horrible thing" that 
you wanted, so it is necessary to repeat the search. You don't have to retype the 
search, because the construction 

// 

is a shorthand expression for "the previous thing that was searched for", 
whatever it was. This can be repeatedas many times as necessary. You can abo 
go backwards, since 

?? 

searches for the same thing, but in the reverse direction. 

You can also use / / as the left side of a substitute command, to mean "the most 
recent pattern". For example, examine: 

/horrible thing/ 

Ed prints the line containing " horrible thing" . 

s//good/p 

This changes "horrible thing" to "good". To go backwards and change 
"horrible thing" to "good", type: 

??s//good/ 
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Exercise 

Experiment with context searching. Scan through a body of text with several 
occurrences of the same string of characters using the same context search. 

Try using context searches as line numbers for the substitute, print, and delete 
commands. (Context searches can also be used with the r, w, and a 
commands.) 

Try context searching using ^tcitt instead of /text/. This scans lines in the 
buffer in reverse order instead of normal order, which is sometimes useful if you 
go too far while looking for a string of characters. It's an easy way to back up in 
the file you're editing. 

If you get imexpected results with any of the characters 

' . $ I . \ & 

read Section A 4, "Context and Regular Expressions". 

A. 4. 13 Changing and Inserting Text: c and i 

This section discusses the change (c) command, which is used to change or 
replace one or more lines, and the insert (i) command, which is used for 
inserting one or more lines. 

The c command is used to replace a number of lines with different lines that you 
type at the terminal. For example, to change lines ".+1" through "$" to 
something else, type: 

.+ l,$c 

type the linee of text you want here ... 



The lines you type between the c command and the dot (.) will replace the 
originally addressed lines. This is useful in replacing a line or several lines that 
have errors in them. 

If only one line is specified in the c command, then only that line is replaced. 
(You can type in as many replacement lines as you like.) Notice the use of a 
period to end the input. This works just like the period in the append command 
and must appear by itself on a new line. If no line number is given, the current 
line specified by dot is replaced. The value of dot is set to the last line you typed 
in. Note that the terminating period and the line referenced by dot are 
completely different: the first is used simply to terminate a command, the 
second points at a specific line of text. 
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The i command is similar to the append command. For example 



/string/i 

type the line$ to be ineerted here 



inserts the given text before the next line that contains "string". The text 
between i and the terminating period is imerted before the specified line. If no 
line number is specified, dot is used. Dot is set to the last line inserted. 



Exercise 

The c command is like a combination of delete followed by insert. Experiment 
to verify that 

$tart,endd 

i 

[text] 

is almost the same as 

etart,endc 
[tett] 

These are not preei$ely the same if the last line gets deleted. 

Experiment with a and i to see that they are similar, but not the same. Observe 
that 

line-number z, 
[text] 

appends after the given line, while 

line-numberi 
[text] 



inserts before it. If no line number is given, i inserts before line dot, while a 
appends after line dot. 



A. 4. 14 Moving Lines: m 

The move (m) command lets you move a group of lines from one place to 
another in the buffer. Suppose you want to put the first three lines of the buffer 
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at the end instead. You could do it by typing 

l,3w temp 
$r temp 
1,3d 

where Ump is the name of a temporary file. However, you can do it more easily 
with the m command: 

1,3ml 
This will move lines 1 through 3 to the end of the file. 
The general case is 

$tart'line,end-lineTaafter-thie-line 

There is a third line to be specified: the place where the moved text gets put. Of 
course, the lines to be moved can be specified by context searches. If you had 

First paragraph 

end of first paragraph. 

Second paragraph 

end of second paragraph. 

you could reverse the two paragraphs like this: 

/Second/,/end of second/m/First/-l 

Notice the -1. The moved text goes after tht line mentioned. Dot gets set to the 
last line moved. Your file will now look like this: 

Second paragraph 

end of second paragraph 

First paragraph 

end of first paragraph 

As another example of a frequent operation, you can reverse the order of two 
adjacent lines by moving the first line after the second line. Suppose that you 
are positioned at the first line. Then 

m+ 

moves line dot to one line after the current line dot. If you are positioned on the 
second line, 

m-- 

moves line dot to one line after the current line dot. 
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The m command is more succinct than writing, deleting and rereading. The 
main difficulty with the m command is that if you use patterns to specify both 
the lines you are moving and the target, you have to take care to specify them 
properly, or you may not move the lines you want. The result of a bad m 
command can be a mess. Doing the job one step at a time makes it easier for you 
to verify at each step that you accomplished what you wanted. It is also a good 
idea to issue a w command before doing anything complicated; then if you 
make a mistake, it's easy to back up to where you were. 

For more information on moving text, see Section A. 4. 18, "Marking Your Spot 
in aFile:k". 



A.4.15 Performing Global Commands: f and v 

The "global" commands g and v are used to execute one or more editing 
commands on all lines that either contain (g) or don't contain (v) a specified 
pattern. 

For example, the command 

g/XENIX/p 

prints all lines that contain the word "XENIX". Tiie pattern that goes between 
the slashes can be anything that could be used in a line search or in a substitute 
command; exactly the same rules and limitations apply. 

For example, 

s/"V/p 

prints all the fro^ formatting commands in a file (lines that begin with "."). 
(For an explanation of the use of the caret (') and the backslash (\) see Section 
A.5, "Context and Regular Expressions". 

The V command is identical to g, except that it operates on those lines that do 
not contain an occurrence of the pattern. (Mnemonically, the "v" can be 
thoughtof as partof the word "inverse". 

For example 
v/'V/p 
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prints all the lines that don't begin with a period (i.e., the actual text lines). . 

Any command can follow g or v. For example, the following command deletes 
all lines that begin with ".": 

g/*\/d 
This command deletes all empty lines: 

6/^S/d 

Probably the most useful command that can follow a global command is the 
substitute command. For example, we could change the word "Xenix" to 
"XENIX" every where, and verify that it really worked, with 

g/Xenix/s//XENIX/gp 

Notice that we used //in the substitute command to mean "the previous 
pattern", in this case, "X^nix". The p command executes on each line that 
matches the pattern, not just on those in which a substitution took place. 

The global command makes two passes over the file. On the first pass, all lines 
that match the pattern are marked. On the second pass, each marked line is 
examined in turn, dot is set to that line, and the command executed. This 
means that it is possible for the command that follows a g or v command to use 
addresses, set dot, and so on, quite freely. For example: 

g/^VP/+ 

prints the line that follows each ".P" command (the signal for anew paragraph 
in some formatting packages). Remember that plus (+) means "one line past 
dot". And 

g/topic/?*\.H?p 

searches for each line that contains the word "topic", scans backwards until it 
finds a line that begins with a ".H" (a heading) and prints it, thus showing the 
headings under which "topic" is mentioned. Finally 

g/\.EQ/+,/'\.EN/-p 

prints all the lines that lie between lines beginning with ".EQ" and ".EN" 
formatting commands. 

The g and v commands can also be preceded by line numbers, in which case the 
lines searched are only those in the range specified. 

It is possible to give more than one command under the control of a global 
command. For example, suppose the task is to change "x" to "y" and "a" to 
"b" on all lines that contain "thing". Then 
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g/thing/s/x/y/\ 
s/a/b/ 

is sufTicient. The backslash (\) signals the g command that the set of 
commands continues on the next line; the g command terminates on the first 
line that does not end with a backslash. 

Note that you cannot use a substitute command to insert a new line within a g 
command. Watch out for this. 

The command 

«/x/s//y/\ 
s/a/b/ 

does network as you might expect. The remembered pattern is the last pattern 
that was actually executed, so sometimes it will be "x" (as expected), and 
sometimes it will be "a" (not expected). You must spell it out, like this: 

g/x/s/x/yA 
s/a/b/ 

It is also possible to execute a, c and i commands as part of a global command. 
As with other multiline constructions, add a backslash at the end of each line 
except the last. Thus, to add an ".nf and ".sp" command before each ".EQ" 
line, type: 

g/'VEQ/i\ 

.nf\ 

.sp 

There is no need for a Bnal line containing a period ( . ) to terminate the i 
command, unless there are further commands to be executed under the global 
command. 



A.4.16 Displaying Tabs and Control Characters: 1 

Eiprovides two commands for printing the contentsof the text you are editing. 
You should already be familiar with p, in combinations like 

l,tp 

to print all the linesyou are editing, or 

s/abc/def/p 

to change "abc" to "def on the current line. Less familiar is the "list" ( I) 
command which gives slightly more information than p. In particular, I makes 
visible characters that are normally invisible, such as tabs and backspaces. If 
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you list a line that contains some of these, 1 prints each tab as ">" and each 
backspace as "<". This makes it much easier to correct the sort of typing 
mistake that inserts extra spaces adjacent to tabs, or inserts a backspace 
followed by a space. 

The ! command also "folds" long lines for printing. Any line that exceeds 72 
characters is printed on multiple lines; each printed line except the last b 
terminated by a backslash ( \ ), so you can tell it was folded. This b useful for 
printing lines longer than the width of your terminal screen. 

Occasionally, the I command will print a string of numbers preceded by a 
backslash, such as \07 or \16. These combinations are used to make visible 
characters that normally don't print, like form feed, vertical tab, or bell. Each 
backslash-number combination represents a single ASCII character. Note that 
numbers are octal and not decimal. When you see such characters, be wary: 
they may have surprising meanings when printed on some terminals. Often 
their presence indicates an error in typing, because they are rarely used. 



A.4.17 Undoing Commands: u 

Occasionally you will make a substitution in a line, only to realize too late that 
it was a mistake. The undo (u) command, letsyou "undo" the last substitution. 
Thus the last line that was substituted can be restored to its previous state by 
typing: 

u 

This command does not work with the g and v commands. 

A.4.18 Marking Your Spot in a File: k 

The mark command, k, provides a facility for marking a line with a particular 
name, so that you can later reference it by name, regardless of its actual line 
number. This can be handy for moving lines and keeping track of them as they 
move. For example 

kx 

marks the current line with the name "x". If a line number precedes the k, that 
line is marked. (The mark name must be a single lowercase letter.) You can 
refer to the marked line with the notation: 



Note the use of the single quotation mark ( ') here. Marks are very useful for 
moving things around. Find the first line of the block to be moved and then 
mark it with: 
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ka 
Then find the last line and mark it with 

kb 
Go to at the place where the text is to be inserted and type: 

'a,'bm. 
A line can have only one mark name associated with it at any given time. 



A.4.1fi Transferring Lines: t 

We mentioned earlier the idea of saving lines that are hard to type or used 
often, to cut down on typing time. Ed provides another command, called t (for 
transfer) for making a copy of a group of one or more lines at any point. This is 
often easier than writing and reading. 

The t command is identical to the m command, except that instead of moving 
lines it simply duplicates them at the place you named. Thtis 

l,$t$ 

duplicates the entire contents that you are editing. 

A common use for t is to create a series of lines that differ only slightly. For 
example, you can type 

a 

Now is the time for all good men to come to the aid of their party. 

t. make a copy] 



s/men/women/ 

t. 

s/Now is/yesterday was/ 

Your file will look like this: 



change it a bit] 
make third copy] 
change it a bit] 



Now is the time for all good men to come to the aid of their party. 
Now is the time for all good women to come to the aid of their party. 
Yesterday was the time for all good women to come to the aid of their party. 



A.4.20 Escaping to the Shell: ! 

Sometimes it is convenient to temporarily escape from the editor to execute a 
XENIX command without leaving the editor. The shell escape (!) command, 
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provides a way to do this. 

If you type 

leommand 

your current editing state is suspended, and the XENIX command you asked for 
is executed. When the command finishes, e(f will signal you by printing another 
exclamation (!); at that pointyou can resume editing. 

A. 5 Context and Regular Expressions 

You may have noticed that things don't work right when you use characters 
such as the period ( . ), the asterisk (*), and the dollar sign ($) in context searches 
and with the substitute command. The reason is rather complex, although the 
solution to the problem is simple. Ed treats these characters as special. For 
instance, in a context search or the first string of the substitute command, the 
period ( . ) means "any character", not a period, so 

Ay/ 

means a line with an "x", any character, and a "y", not just a line with an "x", a 
period, and a "y". A complete list of the special characters that can cause 
trouble follows: 

^ . S I * \ / 

The next few subsections discuss how to use these characters to describe 
patterns of text in search and substitute commands. These patterns are called 
•'regular expressions", and occur in several other important XENIX commands 
and utilities, including grep{C), ee d(C) (See the XENIX Reference Mannal). 

Recall that a trailing g after a substitute command causes all occurrences to be 
changed. With 

s/this/that/ 

and 

s/this/that/g 

the first command replaces the firet "this" on the line with "that". If there is 
more than one "this" on the line, the second form with the trailing g changes all 
of them. 

Either form of the s command can be followed by p or 1 to print or list the 
contents of the line. For example, all of the following are legal and mean 
slightly different things: 
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s/this/that/p 
s/this/that/1 
s/this/that/gp 
s/this/that/gl 

Make sure you know what the differences are. 

Of course, any s command can be preceded by one or two line numbers to 
specify that the substitution is to take place on a group of lines. Thus 

l,$s/mispell/misspell/ 

changes the jir$t occurrence of "mispell" to "misspell" in each line of the file. 
But 

l,$s/mispell/misspell/g 

changes every occurrence in each line (and this is more likely to be what you 
wanted). 

If you add a p or 1 to the end of any of these substitute commands, only the last 
line changed is printed, not all the lines. We will talk later about how to print 
all the lines that were modified. 



A.5.1 Period: (.) 

The first metacharacter that we will discuss is the period ( . ). On the left side of 
a substitute command, or in a search, a period stands for any single character. 
Thus the search 

/xy/ 

finds any line where "x" and "y" occur separated by asingle character, as in 

x+y 
x-y 
X y 
xzy 

and so on. 

Since a period matches a single character, it gives you a way to deal with funny 
characters printed by 1. Suppose you have a line that appears as 

th\07is 

when printed with the 1 command, and that you want to get rid of the \07, 
which represents an ASCII bell character. 
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The most obvious solution is to try 

s/\07// 

but this will fail. Another solution is to retype the entire line. This b 
guaranteed, and is actually quite a reasonable tactic if the line in question isn't 
too big. But for a very long line, retyping is not the best solution. This is 'where 
the metacharacter "." comes in handy. Since \07 really represents a angle 
character, if we type 

s/th. is/this/ 

the job is done. The period matches the mysterious character between the "h" 
and the "i", whatever it is. 

Since the period matches any single character, the command 

s//./ 

converts the first character on a line into a comma (,), which very often is not 
what you intended. The special meaning of the period can be removed by 
preceding it with a backslash. 

As is true of many characters in ed, the period (.) has several meanings, 
depending on its context. This line shows all three: 

.s/././ 

The first period is the line number of the line we are editing, which is called 
"dot". The second period is a metacharacter that matches any single character 
on that line. The third period is the only one that really is an honest, literal 
period. (Remember that a period is also used to terminate input from the a and 
i commands.) On the right side of a substitution, the period ( . ) is not special. If 
you apply this command to the line 

Now is the time. 

the result is 

.ow is the time. 

which is probably not what you intended. To change the period at the end of 
the sentence to a comma, type 

s/\./,/ 

The special meaning of the period can be removed by preceding it with a 
backslash. 
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A.5.2 Backslash: \ 

Since a period means "any character", the question naturally arises: what do 
you do when you really want a period? For example, how do you convert the 
line 

Now is the time. 

into 

Now is the time? 

The backslash ( \ ) turns off any special meaning that the next character might 
have; in particular, "\." converts the "." from a "match anything" into a 
literal period, so you can use it to replace the period in "Now is the time." like 
this: 

s/\./V 
The pair of characters "\." is considered by ed to be a single real period. 

The backslash can also be used when searching for lines that contain a special 
character. Suppose you are looking for a line that contains 

.DE 

at the start of a line. The search 

/.DE/ 

isn't adequate, for it will find lines like 

JADE 
FADE 
MADE 

because the "." matches the letter "A" on each of the lines in question. But if 
you type 

A-DE/ 

only lines that contain ".DE" are found. 

The backslash can be used to turn off special meanings for characters other 
than the period. For example, consider finding a line that contains a backslash. 
The search 

A/ 
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won't work, because the backslash (\) isn't a literal backslash, but instead 
means that the second slash (/) no longer delimits the search. By preceding a 
backslash with another backslash, you can search for a literal backslash: 

AV 

You can search for a forward slash (/) with 

A// 

The backslash turns off the special meaning of the slash immediately following 
so that it doesn't terminate the slash-slash construction prematurely. 

A miscellaneous note about backslashes and special characters: you can use any 
character to delimit the pieces of an s command; there is nothing sacred about 
slashes. (But you must use slashes for context searching.) For instance, in a line 
that contains several slashes already, such as 

//exec //sys.fort.go // etc... 
you could use a colon as the delimiter. To delete all the slashes, type 

s:/::g 
The result is: 

exec sys.fort.go etc... 

When you are adding text with a or i or c, the backslash has no special meaning, 
and you should only put in one backslash for each one you want. 

Exercise 

Find two substitute commands, each of which converts the line 

\A\y 

into the line 
\x\y 

Here are several solutions; you should verify thateach works: 

sAW// 

s/x../x/ 

s/-.y/y/ 
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A.5.3 Dollar Sign: I 

The dollar sign "$", stands for "the end of the line". Suppose you have the line 

Now is the 

and you want to add the word "time" to the end. Use the dollar sign ($) like 
this: 

s/l/ time/ 
to get 

Now is the time 
A space is needed before "time" in the substitute command, or you will get: 

Now is thetime 

You can replace the second comma in the following line with a period without 
altering the first. 

Now is the time, for all good men, 

The command needed is: 

s/,S/./ 

to get 

Now is the time, for all good men. 

The dollar sign ($} here provides context to make specific which comma we 
mean. Without it the s command would operate on the first comma to produce: 

Now is the time, for all good men. 
To convert: 

Now is the time, 
into 

Now is the time? 
as we did earlier, we can use: 

s/.$/?/ 
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Like the period ( . ), the dollar sign ($) has multiple meanings depending on 
context. In the following line 

$s/$/$/ 

the first "$" refers to the last line of the file, the second refers to the end of that 
line, and the third is a literal dollar sign to be added to that line. 



A.5.4 Caret: ' 

The caret ( " ) stands for the beginning of the line. For example, suppose you 
are looking for a line that begins with "the". If you simply type 

/the/ 

you will probably find several lines that contain "the" in the middle before 
arriving at the one you want. But with 

/'the/ 

you narrow the context, and thus arrive at the desired line more easily. 

The other use of the caret ( ' ) enables you to insert something at the beginning 
of aline. For example 

s/7/ 

places a space at the beginning of the current line. 

Metacharacters can be combined. To search for a line that contains only the 
characters 

.P 

you can use the command 
/*\.P$/ 

A.6.5 Star: * 

Suppose you have a line that looks like thb: 

text X y text 

where "text" stands for lots of text, and there are an indeterminate number of 
spaces between the "x" and the "y". Suppose the job is to replace all the spaces 
between "x" and "y" with a single space. The line is too long to retype, and 
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there are too many spaces to count. 

This is where the metacharacter "star'' (*) comes in handy. A character 
followed by a star stands for as many consecutive occurrences of that character 
as possible. To refer to all the spaces at once, type: 

s/x •y/x y/ 

The " *" means "as many spaces as possible". Thus "x *y" means an "x", as 
many spaces as possible, then a "y". 

The star can be used with any character, not just a space. If the original 
example was 

text X ^y text 

then all minus signs (-) can be replaced by a single space with the command: 

s/x-*y/x y/ 
Finally, suppose that the line was: 

text X y text 

If you blindly type 

s/x.*y/x y/ 

The result is unpredictable. If there are no other x's or y's on the line, the 
substitution will work, but not necessarily. The period matches any single 
character so the ".*" matches as many single characters as possible, and unless 
you are careful, it can remove more of the line than you expected. For example, 
if the line was like this 

X text X y text y 

then typing 

s/x.*y/x y/ 

takes everything from the firet "x" to the last "y", which, in this example, is 
undoubtedly more than you wanted. 

The solution is to turn off the special meaning of the period (.) with the 
backslash (\): 

s/x\.*y/x y/ 

Now the substitution works, for "\.*" means "as many periods as possible". 
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There are times when the pattern '*.*" b exactly what you want. For example, 
to change 

Now is the time for all good men .... 
into 

Now is the time, 
use ".*" to remove everything after the "for": 

s/ for.*/./ 

There are a couple of additional pitfalls associated with the star (*). Most 
notable is the fact that "as many as possible" means zero or more. The fact that 
zero is a legitimate possibility is sometimes rather surprbing. For example, if 
our line contained 

xy text X y text 

where the squares represent spaces, and we said 

s/x •y/x y/ 

the first "xy" matches this pattern, for it consists of an "x", zero spaces, and a 
"y". The result is that the substitute acts on the first "xy", and does not touch 
the later one that actually contains some intervening spaces. 

The way around this is to specify a pattern like 

/x *y/ 

which says an "x", a space, then as many more spaces as possible, then a "y", in 
other words, one or more spaces. 

The other pitfall associated with the star (*) again relates to the fact that zero is 
a legitimate number of occurrences of something followed by a star. The 
command 

s/x*/y/s 

when applied to the line 

abcdef 
produces 

yaybycydycyfy 
which is almost certainly not what was intended. The reason for this is that 
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zero is a legitimate number of matches, and there are no x's at the beginning of 
the line (so that gets converted into a "y"), nor between the "a" and the "b" (so 
that gets converted into a "y"}* ^^^ so on. If you don't want zero matches, use 

s/xx«/y/g 
since "xx*" is one or more x's. 



A.5.6 Brackets: [ and ] 

Suppose that you want to delete any numbers that appear at the beginning of 
ail linesof aBle. You might try aseriesof commands like 

i,W*i*// 

l,$s/*3»// 

and so on, but this is clearly going to take forever if the numbers are at all long. 
Unless you want to repeat the commands over and over until finally all the 
numbers are gone, you must get all the digits on one pass. That is the purpose of 
the brackets. 

The construction 

(0123456789] 

matches any single digit — the whole thing is called a "character class". With a 
character class, the job is easy. The pattern "(0123456789]*" matches zero or 
more digits (an entire number), so 

l,$s/*(0123456789l«// 
deletes all digits from the beginning of all lines. 

Any characters can appear within a character class, and there are only three 
special characters (*, ], and -) inside the brackets; even the backslash doesn't 
have a special meaning. To search for special characters, for example, you can 
type: 

n\n/ 

It's a nuisance to have to spell out the digits, so you can abbreviate them as 
(0-9]; similarly, (a-z] stands for the lowercase letters, and (A-ZJ for uppercase. 

Within ( ], the "(" is not special. To get a "]" (or a "-") into a character class, 
make it the first character. 

You can also specify a class that means "none of the following characters". 
This is done by beginning the class with a caret ( ' ). For example 
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(•0-9J 

stands for "any character eieept a digit". Thus, you might find the first line 
that doesn't begin with a tab or space with a search like: 

/*[^(space)(tab)l/ 

Within a character class, the caret has a special meaning only if it occurs at the 
beginning. Just to convince yourself, verify that 

ni/ 

finds a line that doesn't begin with a caret. 

A. 5.7 Ampersand: & 

To save typing, the ampersand {&.) can be used in substitutions to signify the 
string of text that was found on the left side of a substitute command. Suppose 
you have the line 

Now is the time 
and you want to make it: 

Now is the best time 
You can type: 

s/the/the best/ 

It's unnecessary to repeat the word "the". The ampersand (&) eliminates this 
repetition. On the rt^Af side of a substitution, the ampersand means "whatever 
was just matched", so you can type 

s/the/& best/ 

and the ampersand will stand for "the". This isn't much of a saving if the thing 
matched is just "the", but if the match b very long, or if it is something like 
"••" which matches a lot of text, you can save some tedious typing. There is 
also much less chance of making a typing error in the replacement text. For 
example, to put parentheses in a line, regardless of its length, type: 

s/../(&)/ 
The ampersand can occur more than once on the right side. For example 

s/the/& best and & worst/ 
makes 
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Now is the best and the worst time 
and 

s/.*/&? &M/ 
converts the original line into 

Now is the time? Now is the time!! 

To get a literal ampersand use the backslash to turn off the special meaning. 
For example 

s/ampersand/\&/ 

converts the word into the symbol. The ampersand is not special on the left side 
of a substitute command, only on the right side. 



A. 5.8 Substituting New Lines 

Ed provides a facility for splitting a single line into two or more shorter lines by 
"substituting in a newline". For example, suppose a line has become 
unmanageably long because of editing. If it looks like 

text xy text 

you can break it between the "x" and the "y" like this: 

s/xy/x\ 

y/ 

This is actually a single command, although it is typed on two lines. Because 
the backslash (\) turns off special meanings, a backslash at the end of a line 
makes the newline there no longer special. 

You can in fact make a single line into severitl lines with this same mechanism. 
As an example, consider italicizing the word "very" in a long line by splitting 
"very" onto a separate line, and preceding it with the formatting command 
".I". Assume the line in question looks like this: 

text a very big text 

The command 

s/ very /\ 

•I\ 
very\ 
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converts the line into four shorter lines, preceding the word "very" with the 
line ".I", and eliminating the spaces around the "very" at the same time. 

When a new line is substituted in a string, dot is left at the last line created. 



A. 5.0 Joining Lines 

Lines may be joined together, with the j command. Assume that you are given 
the lines: 

Now is 
the time 

Suppose that dot is set to the first line. Then the command 

J 

joins them together to produce: 

Now is the time 

No blanks are added, which is why a blank was shown at the beginning of the 
second line. 

All by itself, a j command joins the lines signified by dot and dot'+'l, but any 
contiguous set of lines can be joined. Just specify the starting and ending line 
numbers. For example, 

joins all the lines in a file into one big line and prints it. 

A. 5. 10 Rearranging a Line: \( and \) 

Recall that "&" is shorthand for whatever was matched by the left side of an s 
command. In much the same way, you can capture separate pieces of what was 
matched. The only difference is that you have to specify on the left side just 
what pieces you're interested in. 

Suppose that you have a file of lines that consist of names in the form 

Smith, A B. 
Jones, C. 

and so on, and you want the initials to precede the name, as in: 
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A. B. Smith 
C. Jones 

It is possible to do this with a series of editing commands, but it is tedious and 
error-prone. 

The alternative is to "tag" the pieces of the pattern (in this case, the last name, 
and the initials), then rearrange the pieces. On the left side of a substitution, if 
part of the pattern is enclosed between \{ and \), whatever matched that part is 
remembered, and available for use on the right side. On the right side, the 
symbol, "\1", refers to whatever matched the first \(...\) pair; "\2", to the 
second \(...\),andso on. 

The command 

1,WA(I*I\).*\(*\)/\2\1/ 

although hard to read, does the job. The first \(...\) matches the last name, 
which is any string up to the comma; this is referred to on the right side with 
"\r\ The second \{...\) is whatever follows the comma and any spaces, and b 
referred to as "\2". 

With any editing sequence this complicated, it's unwise to simply run it and 
hope. The global commands g and v provide a way for you to print exactly 
those lines which were affected by the substitute command, and thus verify 
that it did what you wanted in all cases. 

A.6 Speeding Up Editing 

One of the most effective ways to speed up your editing is knowing what lines 
will be affected by a command if you don't specify the lines it is to act on, and on 
what line you will be positioned (i.e., the value of dot) when a command finishes. 
If you can edit without specifying unnecessary line numbers, you can save a lot 
of typing. 

For example, if you issue a search command like 

/thing/ 

you are left pointing at the next line that contains "thing". Then no address is 
required with commands like s to make a substitution on that line, or p to print 
it, or 1 to list it, or d to delete it, or a to append text after it, or c to change it, or i 
to insert text before it. 

What happens if there is no occurrence of "thing"? Dot is unchanged. This is 
also true if the cursor was on the only occurrence of "thing" when you issued 
the command. The same rules hold for searches that use ?...?; the only 
difference is the direction in which you search. 
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The delete command, d, leaves dot pointing at the line that followed the last 
deleted line. When the line dollar ($) gets deleted, however, dot points at the 
neu; line $. 

The line-changing commands a, c, and i, by default, all affect the current line. 
If you give no line number with them, a appends text after the current line, c 
changes the current line, and i inserts text before the current line. 

The a, c, and i commands behave identically in one respect — when you stop 
appending, changing or inserting, dot points at the last line entered. This is 
exactly what you want when typing and editing on the fly. For example, you 
can type 

a 

text 

botch (minor error) 

s/botch/correct/ (fix botched line) 

a 

more text 



without specifying any line number for the substitute command or for the 
second append command. Or you can type: 

a 

text 

horrible botch (major error) 

c (replace entire line) 

fixed up line 



Experiment to determine what happens if you add no lines with an a, c, or i 
command. 

The r command reads a file into the text being edited, at the end if you give no 
address, or after the specified line if you do. In either case, dot points at the last 
line read in. Remember that you can even type 

Or 

to read a file in at the beginning of the text. (You can also type Oa or It to start 
adding text at the beginning.) 

The w command writes out the entire file. If you precede the command by one 
line number, that line is written out. If you precede it by two line numbers, that 
range of lines is written out. The w command does not change dot: the current 
line remains the same, regardiessof what lines are written out. This is true even 
if you type something like 
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/*\AB/,/*VAE/w abstract 

which involves a context search. 

(Since the w command is so easy to use, you should save what you are editing 
regularly as you go along just in case the system crashes, or in case you 
accidentally delete whatyouVe editing.) 

The general rule is simple: you are left sitting on the last line changed; if there 
were no changes, then dot is unchanged. To illustrate, suppose that there are 
three lines in the buffer, and the line given by dot is the middle one: 

xl 
x2 
x3 

Then the command 

-,+sA/y/p 

prints the third line, which is the last one changed. But if the three lines had 
been 

xl 
y2 
y3 

and the same command had been issued while dot pointed at the second line, 
only the first line would be changed and printed, and that is where dot would be 
set. 



A. 6.1 Semicolon: ; 

Searches with /.../ and ?...? start at the current line and move forward or 
backward, respectively, until they either find the pattern or get back to the 
current line. Sometimes this is not what you want. Suppose, for example, that 
the buffer contains lines like this: 
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ab 



be 



Starting at line 1, you would expect the connmand 

/a/./b/p 

to print all the lines from the "ab" to the "be" inclusive. This is not what 
happens. Both searches (for "a" and for "b") start from the same point, and 
thus they both find the line that contains "ab". As a result, a dngle line is 
printed. Worse, if there had been a line with a "b" in it before the "ab" line, 
then the print command would be in error, since the second line number would 
be less than the first, and it is illegal to try to print lines in reverse order. 

This is because the comma separator for line numbers doesn't set dot as each 
address is processed; each search starts from the same place. In ed, the 
semicolon (;) can be used just like the comma, with the single difference that use 
of a semicolon forces dot to be set at th6 time the semicolon is encountered, as 
the line numbers are being evaluated. In effect, the semicolon "moves" dot. 
Thus, in our example above, the command 

/a/;/b/p 

prints the range of lines from "ab" to "be", because after the "a" b found, dot 
is set to that line, and then "b" is searched for, starting beyond that line. 

This property is most often useful in a very simple situation. Suppose you want 
to find the »ccon</occurrenceof"thing". Youcouldtype 

/thing/ 
// 

but this prints the first occurrence as well as the second, and is a nuisance when 
you know very well that it is only the second one you're interested in. The 
solution is to type: 

/thing/;// 

This says "find the first occurrence of "thing", set dot to that line, then find the 
second occurrence and print only that". 
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Closely related is searching for the second to last occurrence of something, as in: 

Tsomething?;?? 

Finally, bear in mind that if you want to find the first occurrence of something 
in a file, starting at an arbitrary place within the file, it is notsufTicient to type 

l;/thing/ 

because if "thing" occurs on line 1 it won't be found. The command 

0;/thing/ 

will work because it starts the search at line 1. This is one of the few places 
where is a legal line number. 

A.6.2 Interrupting the Editor 

As a final note on what dot gets set to, you should be aware that if you press the 
INTERRUPT key while ed is executing a command, your file is restored, as much 
as possible, to what it was before the command began. Naturally, some changes 
are irrevocable — if you are reading in or writing out a file, making 
substitutions, or deleting lines. These will be stopped in some unpredictable 
state in the middle (which is why it usually unwise to stop them). Dot may or 
may not be changed. 

If you are using the print command, dot is not changed until the printing b 
done. Thus, if you decide to print until you see an interesting line, and then 
press INTERRUPT, to stop the command, dot will not not be set to that line or 
even near it. Dot is left where it was when the p command was started. 

A.7 Cutting and Pasting with the Editor 

This section describes how to manipulate pieces of files, individual lines or 
groups of lines. 

A.7.1 Inserting One File Into Another 

Suppose you have a file called memo, and you want the file called table to be 
inserted just after a reference to Table 1. That is, in me mo somewhere is a line 
that says 

Table 1 shows that ... 

and the data contained in table has to go there. 
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To put table into the correct place in the file edit memo, find "Table 1", and add 
the file table right there: 

ed menno 
/Table 1/ 
reeponte from ed 
.r table 

The critical line is the last one. The r command reads a file; here you asked for 
it to be read in right after line dot. An r command, without any address, adds 
lines at the end, so it is the same as "$r ". 



A.7.2 Writing Out Part of a File 

The other side of the coin is writing out part of the document you're editing. 
For example, you may want to split the table from the previous example out 
into a separate file so it can be formatted and tested separately. Suppose that in 
the file being edited we have 

.TS 

(lots of stuff] 
.TE 

which is the way a table is set up for the tbi program. To isolate the table in a 
separate file called table, first find the start of the table (the ".TS" line), then 
write out the interesting part. For example, first type: 

/ATS/ 
This prints out the found line: 

.TS 
Next type 

.,/'\.TE/w table 
and the job is done. If you are confident, you can do it all at once with 

/'\.TS/;/*\.TE/w table 

The point is that the w command can write out a group of lines, instead of the 
whole file. In fact, you can write out a single line if you like; just give one line 
number instead of two. If you have just typed a horribly complicated line and 
you know that it (or something like it) is going to be needed later, then save it — 
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don't retype it. For example, in the editor, type: 

a 

lots of stuff 

horrible line 

.w temp 

a 

more stuff 

.r temp 

a 

more stuff 



A.8 Editing Scripts 

If a fairly complicated set of editing operations b to be done on a whole set of 
files, the easiest thing to do is to make up a "script", i.e., a file that contains the 
operations you want to perform, then apply this script to each file in turn. 

For example, suppose you want to change every "Xenix" to "XENIX" and every 
"USA" to "America" in a large number of files. Put the following lines into the 
file $eript: 

g/Xenix/s/ZXENDC/g 
g/USA/s//America/g 
w 

q 

Now you can type: 

ed - filel <script 
ed - file2 < script 



This causes ed to take its commands from the prepared file $eript. Notice that 
the whole job has to be planned in advance, and that by using the XENIX shell 
command interpreter, you can cycle through a set of files automatically. The 
dash (-) suppresses unwanted messages from ed. 

When preparing editing scripts, you may need to place a period as the only 
character on a line to indicate termination of input from an a or i command. 
This is difficult to do in ed, because the period you type will terminate input 
rather than be inserted in the file. Using a backslash to escape the period won't 
work either. One solution is to create the script using a character such as the 
at-sign (@) to indicate end of input. Then, later, use the following command to 
replace the at-sign with a period: 
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s/'@$/./ 



A.9 Summary of Commands 

This following is a list of all ed commands. The general form of cd commands is 
the command name, preceded by one or two optional line numbers and, in the 
case of e, f, r, and w, followed by a filename. Only one command is allowed per 
line, but a p command may follow any other command (except e, f, r, w, and q). 

a Appends, i.e., adds lines to the buffer (at line dot, unless a different 
line is specified). Appending continues until a period is typed on a new 
line. The value of dot is set to the last line appended. 

c Changes the specified lines to the new text which follows. The new 
Hnes are terminated by a period on a new line, as with a. If no lines are 
specified, replace line dot. Dot is set to the last line changed. 

d Deletes the lines specified. If none are specified, deletes line dot. Dot is 
set to the first undeleted line following the deleted lines unless dollar 
($) is deleted, in which case dot is set to dollar. 

e Edits a new file. Any previous contents ofthe buffer are thrown away, 
so issue a w command first. 

f Prints the remembered filename. If a name follows f, then the 
remembered name is set to it. 

g The command ^f tiring /commande executes commandt on those 
lines that contain string, which can be any context search expression. 

i Inserts lines before specified line (or dot) until a single period is typed 
on a new line. Dot is set to the last line inserted. 

1 Lists lines, making visible nonprinting ASCII characters and tabs. 
Otherwise similar to p. 

m Moves lines specified to after the line named after m. Dot is set to the 
last line moved. 

p Prints specified lines. If none are specified, print the line specified by 
dot. A single line number is equivalent to a line -numb erp command. 
Asingle RETURN prints ".+1", the next line. 

q Quits ed. Your work is not saved unless you first give a w command. 
Give it twice in a row to abort edit. 

r Reads a file into buffer (at end unless specified elsewhere.) Dot is set to 
the last line read. 
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s The command *^s/etringl/etring8/" substitutes the pattern matched 
by $tringl with the string specified by $tringSin the specified lines. If 
no lines are specified, the substitution takes place only on the line 
specified by dot. Dot is set to the last line in which a substitution took 
place, which means that if no substitution takes place, dot remains 
unchanged. The s command changes only the first occurrence of 
Btringl on a line; to change multiple occurrences on a line, type a g 
after the final slash. 

t Transfers specified lines to the line named after t. Dot is set to the last 
line moved. 

V The command v/ etring/ command$execMtt8 eommandson those lines 
that (/o* not contain $tring. 

u Undoes the last substitute command. 

w Writes out the editing buffer to a file. Dot remains unchanged. 

.» Prints value of dot. (An equal sign by itself prints the value of $.) 

leommand 

The line lemd-line causes emd-ltne to be executed as a XENIX 
command. 

/itring/ 

Context search. Searches for next line which contains this string of 
characters and prints it. Dot is set to the line where string was found. 
The search starts at .+1, wraps around from $ to 1, and continues to 
dot, if necessary. 

^ttringi 

Context search in reverse direction. Starts search at .-1 , scans to 1, 
wraps around to $. 
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-b option 

mail 6-31 
-c option 

mail 6-31 
-r option 

mail 6-31 
-u option 

mail 6-31 
1 command See escape command 

(!) 
$! variable, process 

number 7-1^ 
$# variable, argument 

recording 7-13 
$$ variable, process 

number 7-13 
$- variable, execution 

flags 7-1^ 
$? variable, command exit 

status 7-13 
** See Quotation marks, 

single (•♦) 
(o), write command message 

end 4-29 
(oo), write command message 

end 4-29 
• See Asterisk (*) 
- See Dash (-) 
-a operator 7-34 
-a option 

function 3-10 
-c option, shell 

invocation 7-39 



-e option, shell 

procedure 7-33 
-f option, mail 6-31 
-f option, mail 6-9 
-i option 

mail 6-30 

mail 6-31 

mail 6-39 

mail 6-9 

shell invocation 7-39 
-k option, shell 

procedure 7-33 
-1 option 

function 3-9 
-m option, mail 6-32 
-n option 

echo command 7-35 

shell procedure 7-33 
-o operator 7-34 
-r option 3-9 
-R option, recursive 

listing 4-12 
-s option 

mail, subject 

specification 4-28 

mail, subject 

specification 6-31 

shell invocation 7-39 
-t option, shell 

procedure 7-33 
-u option, shell 

procedure 7-33 
-V option, input line 

printing 7-15 
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-V option 

function 3-10 
-X option t command 

printing 7-15 
• command See Dot command 

(.) 
. command 

vi 5-3 

vi use See Vi 
. See Period (.) 
.profile file 

description, use 7-15 

PATH variable setting 7-12 

variable export 7-13 
/ command See Vi 
/ See Slash (/) 
/bin directory 

/usr/bin duplicate 

determination 7-^4 

command search 7-2 

contents 3-5 

contents 7-32 

name derivation 7-32 
/dev directory 

contents 3-5 
/dev/ con sole directory 

contents 3-5 
/dev/tty directory 

contents 3-5 
/etc/termcap file 4-3 
/lib directory 

contents 3-5 
/tmp directory 4-25 

contents 3-5 
/usr directory 

contents 3-5 



/usr/bin directory 

/bin duplicate 

determination 7-44 

cotnnand search 7-2 

contents 3-5 
command See Vi 
; command See Colon command 

(:) 



See Greater-than sign 
(») 

? See Question mark (?) 

a character, permission 
change 4-18 

a command 

appending See Ed 
ed use See Ed 
mail 6-13 
mail 6-20 
mail 6-34 

Absolute pathname See 
Pathname 

Account, new user 2-1 

Addition See BC 

Addition See Calculation 

Alias command See a 
command 

Alphabetizing See sort 
command 

Ampersand (&) 
and-if operator symbol See 
And-if operator (&&) 
background command 3-9 
background process 4-24 
background process 7-19 
background process 7-54 
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command list 7-19 

ed use See Ed 

interrupt, quit 

inmunity 7-19 

jobs to other 

computers 7-19 

metacharacter See Ed 

off-line printing 7-19 

use restraint 7-19 
And-if operator (&&) 

command list 7-19 

description, use 7-20 

designated 7-5^ 
Append 

ed procedure See Ed 

output append symbol See 

Output 
Appending files 4-7 
Appending See Output 
Argument 

filename 7-3 

list creation 7-3 

mail commands 6-8 

number checking, $# 

variable 7-13 

processing 7-17 

redirection argument 

location 7-8 

shell argument passing 7- 

17 

substitution sequence 7-18 

switch See Switch 

test command argument 7-35 

Arithmetic 
See also BC 



expr command effect 7-35 
askcc option See Nail 
asksubject option See Mail 
Asterisk (•) 
BC 

comment convention 8- 

13 

comment convention 8- 

14 

multiplication operator 

symbol 8-2 

multiplication operator 

symbol 8-4 
directory name, use 
avoidance 7-3 
filename wildcard 3-7 
filename, use 
avoidance 3-4 
mail 

character matching. 6-7 

message saved , header 
notation 6-16 
message saved, header 
notation 6-18 
metacharacter 7-3 
metacharacter 7-54 
pattern matching 
functions 3-7 
pattern matching See 
metacharacter 
special shell variable 7- 
18 
at command 4-22 
At sign (§), mail 6-30 
At sign (e), mail 6-39 
atrm command 4-23 
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auto command, BC 6-18 
autombox option See Mail 
autoprint option See Mail 
b command See Vi 
Background irocess 4-24 
$! variable 7-1M 
ampersand (&) operator 4- 
24 

ampersand (&) operator 7- 
19 

ampersand (&) operator 7- 
54 

CNTRL-D immunity 7-19 
dial-up line 

CNTRL-D effect 7-19 
nohup command 7-19 
INTERRUPT immunity 7-19 
logout immunity 7-19 
QUIT immunity 7-19 
use restraint 7-19 
Backslash (\) 

escape character 2-4 
Backslash (\) 
BC 
comment convention 8- 
13 
Backslash (\) 
BC 
comment convention 8- 
14 
Backslash (\) 
BC 

line continuation 
notation 8-6 
Backslash (\) 

ed See Ed 
Backslash (\) 
erasing 2-4 



Backslash (\) 

line continuation 
notation 7-45 
Backslash (\) 

metacharacter escape 7-4 
Backslash (\) 

quoting 7-55 
BACKSPACE key 

erasure function 2-4 
inserting as text 2-4 
mail 6-11 
mail 6-6 
Batch processing See 

Command 
bcl command, BC 8-13 
be conn and 
BC 

file reading, 
execution 8-13 
invocation 8-1 
calculation 4-30 
BC 

addition operator 

evaluation order 8-15 
left to right binding 
8-4 

scale 8-17 
scale 8-6 
symbol (+) 8-4 
additive operators 
See also Specific 
Operator 

left to right binding 
8-17 
alphabetic register See 
storage register 
arctan function 
availability 8-1 



1-4 



loading procedure 8-13 

array 

auto array 8-18 
characteristics 8-1^ 
identifier 8-U 
identifier 8-19 
name 8-9 

named expression 8-15 
one-dimensional 8-9 

assignment operator 
designated, use 8-17 
evaluation order 8-15 
positioning effect 8-U 

symbol (=) 8-4 
assignment statement 8-12 

asterisk (•) 

comment convention 8- 

13 

comment convention 8- 

14 

multiplication operator 

symbol 8-2 

multiplication operator 

symbol 8-4 
auto consnand 8-18 
auto statement 

built-in statement 8- 

19 
auto, keyword 8-14 
backslash (\) 

comment convention 8- 

13 
backslash (\) 

comment convention 8- 

14 



backslash (\) 

line continuation 

notation 8-6 
bases 8-5 
be -1 command 8-13 
be command 

file reading, 

execution 8-13 

invocation 8-1 
Bessel function 

availability 8-1 

loading procedure 8-13 

BKSP key 8-2 
braces ({}) 

compound statement 

enclosure 8-19 

function body 

enclosure 8-7 
brackets ([]) 

array identifier 8-14 

auto array 8-18 
subscripted variable 
8-9 
break statement 

built-in statement 8- 

19 
break, keyword 8-14 
built-in statement 8-19 
caret C), exponentiation 
operator symbol 8-4 
command See be command 
comment convention 8-13 
comment convention 8-14 
compound statement 8-19 
constant 

ccMiposition 8-14 
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defined 8-15 
construction 

diagram 8-12 

space significance 8- 

12 
control statements 8-9 
cos function 

availability 8-1 

loading procedure 8-13 

define statement 

built-in statement 8- 

19 

description, use 8-20 
define, keyword 8-14 
demonstration run 8-1 
description 8-1 
division operator 

left to right binding 

8-16 

left to right binding 

8-4 

scale 8-17 

scale 8-6 

symbol (/) 8-4 
equal sign (s) 

assignment operator 

symbol 8-4 

relational operator 

8-18 

relational operator 

8-9 
equivalent constructions 
diagram 8-12 
evaluation sequence 8-2 
exclamation point (!) 

relational operator 

8-18 



relational operator 

8-9 

exit 8-1 

exit 8-3 

exponential function 
availability 8-1 
loading procedure 8-13 

exponentiation operator 

right to left binding 

8-17 

right to left binding 

8-4 

scale 8-17 

scale 8-6 

symbol D 8-4 
expression 

enclosure 8-15 

evaluation order 8-14 

named expression 8-15 

statement 8-19 
for statement 

break statement effect 

8-19 

built-in statement 8- 

19 

description, use 8-9 

format 8-20 

range execution 8-10 

relational operator 

8-18 
for, keyword 8-14 
function call 

defined 8-15 

description 8-15 

evaluation order 8-15 

procedure 8-8 
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syntax 8-16 
function 

argument absence 8-8 

array 8-9 

calling See function 

call 

definition procedure 

8-7 

form 8-7 

identifier 8-U 

name 8-7 

parameters 8-8 

return statement See 

return statement 

termination, return 

statement 8-20 

variable automatic 8-7 

global storage class 8-18 

greater-than sign ( 

>), relational 

operator 8-18 

>), relational 

operator 8-9 
hexadecimal digit 

ibase 8-5 

obase 8-6 

value 8-14 
ibase 

decimal input setting 

8-5 

defined 8-15 

initial setting 8-5 

keyword 8-1 M 

named expression 8-15 

setting 8-5 



variable 8-7 
identifier 

array See array 

auto statement effect 

8-19 

description 8-14 

global 8-18 

local 8-18 

named expression 8-15 

value 8-18 
if statement 

built-in statement 8- 

19 

description, use 8-9 

format 8-20 

range execution 8-10 

relational operator 

8-18 
if, keyword 8-14 
INTERRUPT key 8-2 
introduction 8-1 
invocation 8-1 
keywords designated 8-14 
language features 8-12 
length 

built-in function 8-16 

keyword 8-1 4 
less-than sign (<), 
relational operator 8-18 
less-than sign (<), 
relational operator 8-9 
line continuation 
notation 8-6 
local storage class 8-18 
log function 

availability 8-1 
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loading procedure 8-13 

math function library See 
bcl command 
minus sign (-) 

subtraction operator 

symbol 8-4 

unary operator symbol 

8-16 

unary operator symbol 

8-4 
modulo operator 

left to right binding 

8-16 

left to right binding 

8-4 

scale 8-17 

scale 8-6 

symbol (%) 8-4 
multiplication operator 

evaluation order 8-15 

left to right binding 

8-16 

left to right binding 

8-4 

scale 8-16 

scale 8-6 

symbol (») 8-2 

symbol (») 8-4 
multiplicative operators 

See also Specific 

Operator 

left to right binding 

8-16 
named expression 8-15 
negative number, unary 
minus sign (-) 8-4 



obase 

conversion speed 8-6 

defined 8-15 

description 8-5 

hexadecimal notation 

8-6 

initial setting 8-5 

keyword 8-14 

named expression 8-15 

variable 8-7 
operator 

See also Specific 

Operator 

designated, use 8-4 
parentheses (()) 

expression enclosure 

8-15 

function identifier 

argument enclosure 8- 

14 
percentage sign (%), 
modulo operator symbol 
8-4 
plus sign (<!>) 

addition operator 

symbol 8-4 

unary operator symbol 

8-16 
program flow alteration 
8-9 

quit command 8-1 
quit command 8-3 
quit statement 

BC exit 8-20 

built-in statensent 8- 

19 
quit, keyword 8-14 
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quoted string statement 

8-19 

register See storage 

register 

relational operator 

designated 8-18 

designated 8-9 

evaluation order 8-15 
RETURN key 8-2 
return statement 

built-in statement 8- 

19 

description 8-20 

form 8-7 
return, keyword 8-1^ 
scale command 8-7 
scale 

addition operator 8-17 



exponentiation 

operator 8-6 

initial setting 8-7 

keyword 8-1 M 

length function 8-16 

length maximum 8-6 

log function 8-13 

modulo operator 8-17 

modulo operator 8-6 

multiplication 

operator 8-16 

multiplication 

operator 8-6 

named expression 8-15 

sin function 8-13 

square root effect 8- 

16 

square root effect 8-6 



addition operator 8-6 
arc tan function 8-13 
Bessel function 8-13 
built-in function 8-16 

command See scale 

command 

cos function 8-13 

decimal digit value 

8-7 

defined 8-15 

description 8-6 

division operator 8-17 

division operator 8-6 
exponential function 

8-13 

exponentiation 
operator 8-17 



subtraction operator 

8-17 

subtraction operator 

8-6 

value printing 

procedure 8-7 

variable 8-7 
semicolon (;), statement 
separation 8-19 
semicolon (;), statement 
separation 8-3 
sin function 

availability 8-1 

loading procedure 8-13 

slash (/), division 
operator symbol 8-4 
space significance 8-12 
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square root 
built-in function 8-16 

keyword 8-1 M 

result as integer 8-5 

scale procedure 8-6 

sqrt keyword 8-14 
statement 

See also Specific 

Statement 

entry procedure 8-12 

execution sequence 8- 

19 

separation methods 8- 

19 

types designated 8-19 
storage classes 8-18 
storage register 8-4 
subscript 

fractions discarded 

8-9 

truncation 8-14 

value limits 8-9 ■ 
subscripted variable 

array See array 

description 8-9 

subscript See 

subscript 
subtraction operator 

left to right binding 

8-4 

scale 8-17 

scale 8-6 

symbol (-) 8-4 
syntax 8-1 

token composition 8-14 
truncation use when 8-7 



unary operator 

designated 8-16 

evaluation order 8-15 

left to right binding 

8-16 

symbol (-) 8-4 
variable 

automatic 8-18 

automatic 8-7 

name 8-7 

subscripted See 

subscripted variable 
while statement 

break statement effect 

8-19 

built-in statement 8- 

19 

description* use 8-9 

execution 8-21 

range execution 8-10 

relational operator 

8-18 
while, keyword 8-14 
Bessel function See BC 
Binary file See File 
Binary logical and 

operator 7-34 
Binary logical or 

operator 7-34 
BINUNIQ shell procedure 7- 

44 
BKSP key 
BC 8-2 

command-line buffer 
editing 3-9 
BKSP 

vi cursor movement 5-17 
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Block special device 4-16 
Bourne shell 

TERM variable 5-50 
terminal type 5-50 
Braces ({)) 
BC 

compound statement 

enclosure 8-19 

function body 

enclosure 8-7 
command grouping 7-25 
pipeline, command list 
enclosure 7-20 
variable 

conditional 

substitution 7-38 

enclosure 7-11 
Braces command ({}) 7-'^0 
Brackets ([]) 
BC 

array identifier 8-14 

auto array 8-18 

subscripted variable 

8-9 
directory name, use 
avoidance 7-3 
ed metacharacter See Ed 
filename, use 
avoidance 3-4 
metacharacter 7-3 
metacharacter 7-54 
pattern matching See 
metacharacter 
pattern-matching 
functions 3-8 
test command, use in lieu 
of 7-33 



break conunand 

for command control 7-24 

loop control 7-24 

shell built-in command 7- 

40 

special shell connand 7-30 

while command control 7-24 

Buffer See Ed 
Buffers See Vi 5-23 
c command See Ed 
C language 
BC 

comment convention 
similarity 8-13 
syntax agreement 8-1 
shell language 7-1 
C shell 
TERM variable 5-50 
terminal type setting 5-50 

cal command 4-29 
Calculation 

See also BC 

example 4-30 
Calculator functions See 

BC 
calendar command 4-30 
Calendar roninder 

service 6-32 
Caret O 

BC, exponentiation 

operator symbol 8-4 

ed use See Ed 

mail, first message 

specification 6-15 
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mail, first message 

specification 6-3^ 

mail, first message 

specification 6-7 
case command 

description, use 7-22 

exit status 7-22 

redirection 7-26 

shell built-in command 7- 

40 
Case delimiter symbol 

(;;) 7-5M 
Case significance 2-2 
Case-part 7-52 
cat command 

ed See Ed 

file 
combining 4-7 
contents display 2-3 
Cat 

command 4-7 
cd arg command 7-30 
cd command 4-15 

directory change 3-5 

directory change 7-14 

mail 6-22 

mail 6-34 

parentheses use 7-14 

time consumption 

minimization 7-42 
Changing password 4-2 
Changing terminal types 4-3 
Character class See Ed 
Character counting 4-22 
Character special 

device 4-16 
chmod consnand 4-17 



chmod command 4-19 
directory permission 
change 3-2 
file permission change 3-1 

chron option See Mail 
CNTRL-D 

background process 

immunity 7-19 

BC exit 8-2 

BC exit 8-3 

end-of-file 4-2 

logging out 2-5 

mail 4-28 

message sending 6-10 
message sending 6-3 
reply message 
termination 6-12 
reply message 
termination 6-19 

shell exit 6-21 

shell exit 7-25 

vi scroll 5-20 
CNTRL-F 

vi scroll 5-20 
CNTRL-G 

vi See Vi 5-11 
CNTRL-H, mail 6-6 
CNTRL-Q, output 

resumption 4-4 
CNTRL-S, output 

stopping 4-4 
CNTRL-U 

command-line buffer 

editing 3-9 

inserting as text 2-4 

kill character 2-4 
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line kill 4-4 

mail, line killing 6-11 

mail, line killing 6-6 

vi scroll 5-20 
Co command See Vi 
Colon (:) 

command See Colon command 

(:) 

mail 

command escape 6-26 
network mail 6-13 

PATH variable use 7-12 

variable conditional 

substitution 7-38 

vi use See Vi 
Colon command ( : ) 

description 7-30 

shell built-in command 7- 

40 

special shell command 7-30 

Command line 

ampersand (&) effect 3-9 
buffer defined 3-9 
defined 3-8 
entry 4-4 
erasure 4-4 
execution 7-18 
interpretation 3-9 
multiple commands 
entry 3-9 
options 

See also Specific 

Option 

designated 7-39 
pipeline, use in 7-20 
rescan 7-18 



RETURN key effect 4-4 

scanning sequence 7-18 

substitution 7-8 
Comnand list 

case command, 

execution 7-22 

defined 7-19 

for command, execution 7- 

23 

grammar 7-52 
Command 

See also Specific Command 

background submittal 3-9 
batch processing See 
background submittal 
dash (-) use 3-4 
defined 7-19 
delimiter See Ed 
directory See /bin 
directory 

directory See Directory 
ed commands See Ed 
enclosure in parentheses 
(()), effect 7-40 
environment 7-15 
execution 3-8 
execution 7-2 

RETURN key required 2-2 

sequence 4-24 

time 7-40 
exit status See Exit 
status 

grammar 7-52 
grouping 

exit status 7-26 
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parentheses (()) 

use 7-54 

procedure 7-25 

WRITEMAIL shell 

procedure 7-51 
keyword parameter 7-15 
line See Command line 
list See Command list 
lowercase letters 3-9 
mail commands summary 6-33 

multiple commands 
entry 3-9 
multiple commands 
entry 7-8 
name error 2''2 
output substitution 
symbol 7-54 

private command name 7-2 
program invocation 3-8 
public command name 7-2 
RETURN key required 2-2 
search 

PATH variable 7-12 

process 7-42 
separation symbol (;) 7-54 

shell, built-in commands 
designated 7-40 
simple command 

defined 7-19 

defined 7-2 

grammar 7-52 
slash (/) beginning, 
effect 7-2 

special shell commands See 
Shell 



special shell commands See 
Specific Special Comnand 
substitution 

back quotation marks 

C^) 7-4 

double quotation narks 

(\0 

procedure 7-8 

redirection 

argument 7-6 
syntax 3-9 
typing error 
correction 2-4 
vi commands See Vi 
Commands 
at 4-22 
atrm 4-23 
cal 4-29 
cat 4-7 
cd 4-15 
copy 4-14 
cp 4-8 
date 4-29 
diff 4-19 
diff3 4-20 
echo 4-20 
find 4-9 
head 4-6 
kill 4-26 
Ic 4-11 
in 4-10 
Ipr 4-27 
mkdir 4-13 
more 4-5 
mv 4-8 
passwd 4-2 
ps 4-24 
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pwd 4-14 

rm 4-9 

rndir 4-13 

sort 4-20 

stty 4-4 

tail 4-6 

wc 4-22 
Comnunication See Mail 
Comparing files 4-19 
compose escapes 6-1 
Compose escapes See Mail 
Concatenate See cat 

command 
Console 2-2 
continue command 

for command control 7-24 

shell built-in command 7- 

40 

special shell command 7-30 

until command control 7-24 
while command control 7-24 

Control characters 

filename use 

restrictions 3-4 
Control command 

See also Specific Control 

Command 

redirection 7-26 
Copy command 4-14 
Copying a directory 4-14 
Copying files 4-8 
Copying See cp command 
COPyPAIRS shell 

procedure 7-44 



COPYTO shell procedure 7-45 
Counting, wc command 4-22 
cp command 4-8 
CR key See RETURN key 
Creating a directory 4-13 
Creating a file 4-5 
Current directory 

change 3-5 
procedure 4-14 

description 4-14 

printing 4-11 

shorthand name 3-6 

user residence 3-6 
Current line 

See Vi 
Cursor movement 

vi See Vi 
Cutting and pasting 

procedure See Ed 
D command See Vi 
d command 

ed use See Ed 

mail* message deletion See 

Mail 
d$ command See Vi 
dO command See Vi 
Dash (-), permission 

denial notation 4-16 

ordinary file notation 4- 

16 
Dash (-) 

comnand option use 3-4 

filename, use 

avoidance 3-4 

switch use 3-9 
date command 2-2 
Date command 4-29 
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dd command See Vi 
Delete buffer See Vi 
Deleting a file 4-9 
Deletion See d command 
Deletion 

vi procedure See Vi 
Delimiter See Ed 
Demonstration 2-1 
Device special file See 

Special file 
Device 

filename 3-4 

filenamerequired 3-4 

pathname 3-4 
Diagnostic output See 

Output 
Dial-up line See Background 

process 
Diff command 4-19 
diff3 4-20 
Digit grammar 7-52 
Directory 

/bin See /bin directory 

/dev See /dev directory 

/lib See /lib directory 

/tmp directory 4-25 

/tmp See /tmp directory 

/tty See /tty directory 

/usr See /usr directory 

access permission See 

Permission 

changing 4-14 

command See cd command 

composition 3-2 

copying 4-14 

creating 4-13 

current directory See 

Current directory 



description 3-2 
diagram 3-3 
file See File 
filename 

required 3-4 

unique to directory 3-4 

listing 4-12 

columns 4-11 
logging in result 3-2 
long listing 4-12 
name, metacharacter 
avoidance 7-3 
nesting 3-2 
parent directory See 
Parent directory 
pathname required 3-4 
permission notation 4-16 
permission See Permission 

protection 3-2 

recursive listing 4-12 

removing 4-13 

renaming 4-13 

search permission See 

Permission 

search 

optimum order 7-42 
PATH variable 7-42 
sequence change 7-3 
size effect 7-43 
time consumption 7-42 

size consideration 7-43 

user control 3-2 

working directory See 

Current directory 
Displaying a file 4-5 
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DISTINCT 1 shell 

procedure 7-^5 
Division See BC 
Division See Calculation 
Dollar sign ($) 

ed use See Ed 

nail, final message 

specification 6-15 

nail, final message 

specification 6-3^ 

mail, final message 

specification 6-7 

positional parameter 

prefix 7-10 

positional parameter 

prefix 7-11 

PS1 variable default 

value 7-13 

variable prefix 7-11 

vi See Vi 
Dot (.) 

command See Dot command 

(.) 

ed use See Ed 

mail, current message 

specification 6-15 

mail, current message 

specification 6-7 

vi use See Vi 
Dot command ( • ) 

description, use 7-27 

shell built-in command 7- 

40 

shell procedure 

alternate 7-32 

special shell command 7-30 



Dot option See Mail 
Double quotation marks See 
Quotation narks, double 
(\0 
dp command See Hail 
DRAFT shell procedure 7-46 
dw command See Vi 
dw command See Vi 5-27 
e command 

ed use See Ed 
mail 6-34 
mail 6-7 
mailR 6-21 
echo command 2-3 
echo command 4-20 
-n option effect 7-35 
description, use 7-35 
mail 6-34 
syntax 7-35 
Ed 

a command 
append A-3 
append A-48 
backslash (N) 
characteristics A-32 
dot (.) setting A-41 
dot (.) setting A-48 
global combination A-24 

input termination A-30 
input termination A-4 
abortion, q command A-48 
address arithmetic A-9 
ampersand (&) 
literal A-38 
metacharacter A-38 
substitution A-38 
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append See a command 
asterisk (»), 
metacharacter A-27 
asterisk (»), 
metacharacter A-34 
at sign (e), script A-47 
backslash (\) 

a comRiand A-32 
backslash (\) 

c command A-32 
backslash (\) 

g command A-24 
backslash (\) 

i command A-32 
backslash (\) 

line folding A-25 
backslash (\) 

literal A-31 
backslash (\) 

metacharacter A-27 
backslash (\) 

metacharacter A-30 
backslash (\) 

metacharacter 

escape A-30 
backslash (\) 

metacharacter 

escape A-31 
backslash (\) 

metacharacter 

escape A-38 
backslash (\) 

metacharacter 

escape A-39 
backslash (\) 

multiline 

construction A-24 



backslash (\) 

number string A-25 

backslash (\) 
V command A-24 

backspace printing A-25 

brackets ([]) 

character class A-37 
metacharacter A-27 
metacharacter A-36 

buffer 

description A-M 
vjriting to file See w 
command 

c command 

backslash (\) 
characteristics A-32 
dot (•) setting A-20 
dot (.) setting A-41 
dot (.) setting A-48 
global combination A-24 

input termination A-20 

line change A-19 

line change A-48 
caret O 

character class A-37 

line beginning 

notation A-33 

metacharacter A-27 

metacharacter A-33 
cat command A-6 
change command See c 
command 

character class A-37 
character 

deletion at line 

beginning A-36 
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command 

See also Specific 
Command 

combinations A-2M 
delimiter character A- 

31 

description k-H 
editing command See e 
command 
form A-M8 
INTERRUPT key 
effect A-45 
listing A-48 
multicommand line 
restrictions A-.15 
summary A->il8 
context search See search 

current line See dot (•) 
cutting and pasting 

move command See m 

command 

procedures A-M5 
d command 

deletion A-12 

deletion A-48 

dot (.) setting A-M1 

dot (.) setting A-48 
deletion See d command 
delimiter 

character choice A-31 
description A-1 
dollar sign ($) 

last line notation A-12 

last line notation A-33 



last line notation A-8 
line end notation A-32 
line end notation A-33 
metacharacter A-27 
metacharacter A-32 
multiple functions A-33 

dot (.) 

current line 

notation A-9 

description A-11 

determination A-41 

search setting A-1 6 

search setting A-M9 

substitution 

setting A-1 4 

symbol (.) A-11 

symbol (•) A-30 

value determination A- 

12 

value determination A- 

49 
duplication See t command 

e command A-48 
e command A-6 
edit See e command 
entry A-3 
equals sign (:) 

dot value printing 

(.=) A.12 

dot value printing 

(.=) A-49 

last line value 

printing A-M9 
escape command (!) A-27 
escape command (!) A-49 
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exclamation point (!), 
escape conmiand A-27 
exit See q command 
f command A-48 
f command A-7 
file 

insertion into another 

file A-il5 

writing out A-M5 
filename 

change A-? 

recovery A-T 

remembered filename 

printing A-48 

remembered filename 

printing A-7 
folding A-25 
g command 

a command 

combination A-24 

backslash (\) use A-24 

c command 

combination A->24 

command 

combinations A-23 

command 

combinations A-24 

dot (.) setting A-23 

i command 

combination A-24 

line number 

specifications A-24 

multiline 

construction A-24 

8 command 

c omb in a t ion A-23 

s command 

combination A-49 



search, command 
execution A-22 
search, command 
execution A->48 
substitution A-15 
substitution A-28 
trailing g A-28 

global command See g 

command 

global command See v 

command 

greater-than sign (», tab 
notation 
A-25 

grep command A-28 

hyphen (-) , character 

class A-37 

i command 
backslash (\) 
characteristics A-32 
dot (•) setting A-20 
dot (.) setting A-41 
dot (.) setting A-48 
global combination A-24 

input termination A-30 
insertion A-19 
insertion A-48 
in-line input scripts 7-47 

input 

termination A-20 

termination A-30 

termination A-4 
insert command See i 
command 
INTERRUPT key 

command execution 
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effect A-il5 

dot (.) setting A-45 

print stopping A-8 

introduction A-1 

invocation A-3 

j command, line 

joining A-39 

k command* line 

marking A-25 

1 command 

folding A-25 
line listing A-25 
line listing A-it8 
nondisplay character 
printing A-25 
number string A-25 
8 command 
combination A-28 

less-than sign (<) 

backspace notation A-25 

line beginning 

character deletion A-36 

notation A-33 
line end 

notation A-32 
line number 

as line number A-44 

combinations A-9 

summary A-48 
line 

beginning See line 

beginning 

break See splitting 

folding A-25 

joining A-39 



marking A-26 
moving See m command 
number See line number 

rearrangement A-^0 
splitting A-39 
writing out A-M6 

list See 1 command 

m command 

dot (.) setting A-22 
dot (.) setting A-M8 
line moving A-21 
line moving A-48 
warning A-22 

mail system See Mail 

marking See k command 

metacharacter 

ampersand (&) A-38 
asterisk (•) A-27 
asterisk (») A-3M 
backslash (\) A-27 
backslash (\) A-30 
brackets ([]) A-27 
brackets ([]) A-36 
caret D A-27 
caret C) A-33 
character class A-37 
combination A-3^ 
dollar sign ($) A-27 
dollar sign ($) A-32 
escape A-31 
escape A-38 
period (.) A-27 
period (.) A-29 
search A-37 
slash (/) A-27 
star («) A-27 
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star (») A-34 
minus sign (-), address 
arithmetic A-9 
move 

cominand See m command 

line marking A-26 
multicommand line 
restrictions A-.15 
new line 

substitution A-39 
no ndi splay character 
printing A-25 
p command 

dot (.) setting A-45 

multicommand line A-15 

printing A-M8 

printing A-8 

s command 

combination A-28 
pattern search See search 

per iod ( . ) 
a command input 
termination A-30 
a cc»nmand input 
termination A-4 
c command input 
termination A-20 
char acter 

substitution A-29 
dot symbol See Dot (.) 

i command input 
termination A-30 
literal A-30 
metacharacter A-27 



metacharacter A-29 
s command, effect A-29 
script problems A-M7 
search probl€»ns A-27 
troff command 
prefix A-23 

plus sign (.*), address 

arithmetic A-9 

print 
command See p command 

line folding A-25 
RETURN key effect A-12 
stopping A-8 

q command 

abortion use A-48 
quit session A-48 
quit session A-5 
w command 
combination A-48 

question mark (?) 
exit warning A-3 
search error message 
(?) A-16 
search repetition 
(??) A-18 
search, reverse 
direction (? ?) A-17 
search, reverse 
direction (? ?) A-i»9 
write warning A-5 

quit See q command 

quotation marks, single 
('») 
line marking A-26 

r command 

dot (.) setting A-42 
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dot (.) setting A-MS 

file insertion A-il5 

positioning without 

address A-M5 

read file A-48 

read file A-7 
reading See r command 
regular expression 

description A-28 

metacharacter list A-27 

RETURN key, printing A-48 
s command 

ampersand (&) A-38 

character match A-29 

description, use A-13 

description, use A-49 

dot (.) setting A-14 

dot (.) setting A-U1 

dot (.) setting A-ii9 

g command 

combination A-15 

g command 

conbination A-23 

g command 

combination A-^9 

1 command 

combination A-28 

line number A-28 

new line A-39 

p command 

combination A-28 

search combination A-17 

text removal A-15 
trailing g A-28 
undoing A-25 



V command 

combination A-23 
script A-M7 
search 

dot (.) setting A-il9 

error message (?) A-16 

forward search (/ 

/) A-16 

forward search (/ 

/) A-49 

global search See g 

command 

global search See v 

command 

metacharacter 

problems A-27 

next occurrence 

description A-16 

procedure A-1 6 

repetition (//), 

(??) A-18 

reverse direction (? 

?) A-17 

separator A-43 

substitution 

combination A-17 
sed command A-28 
semicolon (;) 

dot (.) setting A-MU 

search separator A-M3 
shell 

escape See escape 

command (!) 
slash (/) 

delimiter A-31 

literal A-31 

metacharacter A-27 
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search forward (/ 

/) A-16 

search forward (/ 

/) A-M9 

search repetition 

(//) A-18 
special character See 
netacharacter 
spelling correction See s 
coniinand 
star (»), 

netacharacter A-27 
star (»), 

metacharacter A-3^ 
substitution 

command See s ccnmnand 

t command 
dot (.) setting k-^9 
transfer line A-26 
transfer line A-M9 

tab printing A-25 

tbl command A-46 

termination See q command 

text 
removal See s command 

saving A-5 
transfer See t command 
troff command printing A- 
23 

typing error correction 
See s command 
u command 

undo A-25 

undo A-49 



undo See u command 
V command 

a command 

combination A-24 

backslash (\) use A-2U 

c command 

combination A-24 

command 

combinations A-23 

command 

combinations A-24 

dot (.) setting A-23 

global search, 

substitute A-22 

global search, 

substitute A-49 

i command 

combination A-24 

line number 

specifications A-24 

s command 

combination A-23 
w command 

description, use A-5 

dot (.) setting A-42 

dot (.) setting A-49 

e coimnand 

ccmibination A-48 

file write out A-45 

frequent use 

advantages A-42 

line write out A-46 

write out A-45 

write out A-49 

write out A-5 
write out 

command See w command 
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warning A-5 
EDFIND shell procedure 7-^7 
Editor See Ed 
EDITOR string, mail 6-29 
EDITOR string, mail 6-39 
EDLAST shell procedure 7-^7 
egrep See grep command 
el if clause See if coranand 
else clause See if command 
Else-part grainnar 7-52 
Empty grammar 7-52 
ENTER key See RETURN key 
Equal sign (s) 
BC 

assignment operator 

symbol 8-4 

relational operator 

8-18 

relational operator 

8-9 
ed use See Ed 
mail, message number 
printing 6-16 
mail, message number 
printing 6-3U 
variable 
cond itional 
substitution 7-38 
string value 
assignment 7-10 
errdirect file 7-28 
Error output 

redirection 7-37 
ESCAPE key 
vi See Vi 
Escape string, mail 6-29 
Escape string, mail 6-39 



eval command 

command line rescan 7-18 
shell built-in command 7- 
40 
Ex, ed similarity A-1 
Exclamation point (!) 
BC, relational operator 
8-18 

BC, relational operator 
8-9 

ed use See Ed 
mail 

network mail 6-13 
shell command 
execution 6-21 
shell command 
execution 6-25 
shell comnand 
execution 6-34 
unary negation 
operator 7-34 
vi See Vi 
exec arg command 7-30 
exec command 7-40 
Exit code See $? variable 
exit command 

shell built-in command 7- 

40 

shell exit 7-25 

special shell command 7-30 

Exit status 

$? variable 7-13 
case command 7-22 
cd arg command 7-30 
colon command (:) 7-30 
command grouping 7-26 
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false canmand 7-36 

if command 7-21 

read command 7-30 

true command 7-36 

until command 7-23 

wait consnand 7-31 

while command 7-23 
Exponentiation See BC 
Exponentiation See 

Calculation 
export command 

shell built-in command 7- 

HO 

variable 

example 7-13 
listing 7-16 
setting 7-15 
expr command 7-35 
F command » mail 6-12 
F command* mail 6-20 
F command, mail 6-35 
f command 

ed use See Ed 

mail 6-11 

mail 6-12 

mail 6-19 

mail 6-35 
false connnand 7-36 
fgrep See grep command 
fi command 

if command end 7-21 

mail 6-35 
File descriptor 

description, use 7-5 

redirection 7-37 

redirection 7-6 
File permission 

changing 4-17 



File permissions, 

listing 4-12 
File system 
defined 3-3 
diagram 3"^ 
organization 3-3 
File 
access 

control 3-1 

last access time 3-1 

permission See 

Permission 
addition See creation 
alphabetizing See sort 
appending 4-7 
attributes 3-1 
binary file 3-1 
combining 4-7 
composition 3-1 
copying 4-8 
creating 4-5 

with vi 5-2 
creation 

MKFILES shell 

procedure 7-49 

permission See 

Permission 

time 3-1 

write permission 

control 3-2 
defined 3-1 
deleting 4-9 
deletion 

write permission 

control 3-2 
descriptor See File 
descriptor 
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directory See Directory 

displaying 4-5 

displaying 4-6 

displaying 4-7 

editing See Vi 

filename See Filename 

grammar 7-52 

inode number See Inode 

number 

linking 4-10 

listing 3-2 

mail system files See 

Mail 

manipulation 4-4 

modification time 3-1 

moving 4-7 

moving 4-8 

name See Filename 

paginating 4-27 

pathname required 3-4 

pathname, printing 4-14 

pattern search See Ed 

pattern search See grep 

command 

pattern search See Pattern 

matching facility 

permission See Permission 

permissions 4-15 

pipe interchange 7-46 

printing See Linepr inter 

protection 3-1 

removal 4-9 

renaming 4-8 

scratch file directory 3-6 

shell procedure 
creation 7-31 



size in bytes 3-1 

sorting 4-20 

special file See Special 

file 

temporary file See 

Temporary file 

textual contents 

determination 7-51 

types designated 3-1 

variable file creation See 

Variable 
Filename 

argument 7-3 

asterisk (•) wildcard 3-7 

characters use 

restrictions 3-4 

description 3-4 

ed See Ed 

example designated 3-6 

long listing 4-12 

question mark (?) 

representation 3-8 

required 3-1 

required 3-4 

unique to directory 3-4 
Files 

comparing 4-19 
Filter 

description 7-7 

order consideration 7-41 
find command 4-9 
Finding a file 4-9 
finger command 4-25 
Flag See Option 
fmt command, mail 6-25 
for command 

break command effect 7-24 
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continue command 

effect 7-2^ 

description, use 7-23 

redirection 7-26 

shell built-in command 7- 

i»0 
for loop, argument 

processing 7-17 
Foreground process 4-24 
fork command 7-40 
FSPLIT shell procedure 7-48 
Full pathname See Pathname 
g command See Ed 
G command 

vi See Vi 
Global 

ed use See Ed 

variable check 7-33 
goto command 

See G command 5-5 
Greater-than sign ( 

)>BC, relational 
operator 8-18 
)>BC, relational 
operator 8-9 
)>file combination 4-7 
)>output 

redirection 3-11 
)>PS2 variable default 
value 7-13 
)>redirection 
symbol 2-3 
)>redirection 
symbol 7-54 
grep command 4-21 
ed See Ed 



Group permission See 

Permission 
h command 

mail 6-16 

mail 6-35 

mail 6-9 

vi use See Vi 
H nag, mail 6-17 
head command 4-6 
headers command See Mail 
ho command See Nail 
Home directory 4-15 
HOME variable 

conditional 

substitution 7-39 

description 7-12 
i command See Ed 
if command 

COPYTO shell procedure 7* 

45 

description, use 7-20 

exit status 7-21 

fi command required 7-21 

multiple testing 

procedure 7-21 

nesting 7-21 

redirection 7-26 

shell built-in command 7' 

40 

test command 7-33 
IFS variable 7-12 
ignore option See Mail 
ignorecase option See 

Vi 5-36 
In-line input document See 

Input 
Inode number 

defined 3-2 
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link See Link 

Is command S-S 

required for file 3-1 

required for file 3-2 
Input 

ed See Ed 

grammar 7-52 

in-line input 
document 7-36 
EDFIND shell 
procedure 7-^7 

keyboard origin 3-10 

redirection See 

Redirection 

standard input file 7-5 

termination 4-2 
Insert mode See Vi 
Insertion See Ed 
Internal field separator 

shell scanning 

sequence 7-18 

spec i fie a i ton by IFS 

variable 7-12 
INTERRUPT key 

background process 

immunity 7-19 

BC 8-2 

command-line buffer 

cancellation 3-9 

ed use See Ed 

foreground process 

killing 4-24 

logging in, nonsense 

character removal 2-1 

mail 

askcc switch 6-27 
message abortion 6-11 



message abortion 6-28 

program stopping 2-5 
Interrupt 

handling methods 7-27 

key See INTERRUPT key 
Invocation flag See Option 
Item grammar 7-52 
J coRinand See Ed 
j command 

vi use See Vi 
k command See Ed 
k command 

vi use See Vi 
Keyword parameter 

-k option effect 7-33 

description 7-15 
Kill character See CNTRL-U 
kill command 4-24 
kill command 4-26 
Killing a process 4-24 
1 command 4-12 

ed use See Ed 

mail 6-19 

nail 6-35 

vi use See Vi 
Ic connand 4-11 

listing 2-3 
Less-than sign (<) 

BC, relational operator 

8-18 

BC, relational operator 

8-9 

redirection symbol 7-54 
Less-than symbol CO 

input redirection 3-12 
line command 

shell variable value 

assignment 7-9 
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Line-oriented commands See 

Vi 5-12 
Line 

beginning See Ed 

counting See wc command 

writing out See Ed 
linen umber option See Vi 
Linepr inter 

command See Ipr command 

file printing 4-27 

queue information 4-26 

queue information 4-27 
Link 

command See In conmiand 

defined 3-2 

description 4-10 

long listing 4-12 
Linking files 4-10 
list command 

mail 6-35 
list option See Vi 
LISTFIELDS shell 

procedure 7-49 
Listing directory 

contents 4-1 1 
Listing See 1 command 
Listing See Ic command 
In command 4-10 
Logging in 4-1 

nonsense character 

removal 2-1 

procedure 2-1 

prompt character 2-1 

resetting terminal 

charchteristics 2-4 

type-ahead not allowed 2-4 



Logging out 

background process 

immunity 7-19 

procedure 2-5 

procedure 4-2 

shell termination 7-25 
Login directory 

defined 7-12 

new user 2-1 
Login message 2-1 
Login 

procedure 4-1 
Looping 

break command 7-24 

continue command 7-24 

control 7-24 

expr command 7-36 

false conanand 7-36 

for command 7-23 

iteration counting 

pfocedure 7-36 

time consumption 7-40 

true command 7-36 

unconditional loop 

implementation 7-36 

until conmand 7-23 

while command 7-22 

while loop 7-44 
Ipr command 

file printing 4-27 

mail 

-m option 6-32 
message printing 6-19 
message printing 6-35 

pipe 4-27 

pr command combination 4- 

27 
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Is ccxninand 

echo » use in lieu of 7-35 

function 3-2 

inode number use 3-2 
in conunsnd 

ed See Ed 

mail 6-19 

mail 6-35 
N flag See Mail 
magic option See Vi 
mail command See Mail 
MAIL variable 7-12 
Mail 

-b option 6-31 

-c option 6-31 

-R option 6-31 

-u option 6-31 

-f option 6-31 

-f option 6-9 

-i option 6-30 

-i option 6-31 

-i option 6-39 

-i option 6-9 

-m option 6-32 

-s option 4-28 

-s option 6-31 

.mailrc file 

alias contents 6-20 
distribution list 
creation 6-13 
example 6-27 
options setting 6-13 
set command 6-20 
unset command 6-20 

? cc»nmand See help c(Mnmand 

(?) 



a command See alias 
accumulation 6-32 
Alias 6-34 
alias 

a command 6-13 

a command 6-20 

a command 6-34 

display 6-13 

network mail 6-13 

personal 6-13 

personal 6-27 

R command 6-13 

system-wide 6-27 
askcc option 6-13 
askcc option 6-27 
askcc option 6-39 
asksubject option 6-27 
asksubject option 6-39 
asterisk (*) 

character matching 6-7 

message saved, header 

notation 6-16 

message saved, header 

notation 6-18 
at sign (§) , ignore switch 
echo 6-30 

at sign (§) , ignore switch 
echo 6-39 
autombox option 

description, use 6-30 

description, use 6-39 

effect 6-18 

H flag 6-17 

ho command 6-19 
autoprint option 6-28 
autoprint option 6-39 
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BACKSPACE key 6-11 

BACKSPACE key 6-6 

Bcc field See blind carbon 

copy field 

blind carbon copy field 

description 6-5 

editing 6-23 

editing 6-24 

escape See bcc escape 

box See Mailbox 
carbon copy field 

additions prompt 6-13 

blind See blind carbon 

copy field 

description 6-5 

display 6-4 

editing 6-24 

escape See c escape 

escape See cc escape 

option See askcc 

option 

R command effect 6-12 
caret ("), first message 
specification 6-15 
caret (^), first message 
specification 6-34 
caret ('^)t first message 
specification 6-7 
cc field See carbon copy 
field 

cd command 6-22 
cd command 6-34 
chron option 6-28 
chron option 6-39 
CNTRL-D 

message reply 6-12 



message reply 6-19 
message sending 6-10 
CNTRL-H, backspace 6-6 
CNTRL-U, line killing 6-11 

CNTRL-U, line killing 6-6 
colon ( : ) 

escape See command 

escape ( :) 

network mail 6-13 
command escape ( : ) 6-26 
command escape ( :) 6-37 
command line options 6-31 
command mode 

description* use 6-7 

help command 6-14 

options setting 6-13 
command 

See also Specific 

Command 

descriptions 6-14 

escape See command 

escape ( :) 

invocation 6-14 

mail command See mail 

command 

summary 6-33 

syntax 6-8 
compose escape ( !) 6-37 
compose escape ( I ) 6-37 
compose escapes 

See also Specific 

Escape 

compose mode exit 6-6 

edit mode entry 6-7 

heading escapes 6-23 

listing 6-11 
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listing 6-2 

n command 6-19 

reply 6-19 

summary 6-37 

tilde ( ) component 6- 

11 
compose mode 

compose escapes See 

compose escapes 

description, use 6-6 

edit mode entry 6-7 

entry from command 

mode 6-1 1 

entry from shell 6-11 

tilde escapes See 

compose escapes 
concepts 6-4 
d command 4-28 
d command 6-11 
d command 6-17 
d command 6-34 
d command 6-4 
d command 6-7 
dead. letter file 

escape See d escape 

no save switch 

effect 6-28 

undelivered message 

receipt 6-10 
deletion See message 
distribution list 
creation 6-12 
dollar sign ($), final 
message specification 6-15 

dollar sign ($), final 
message specification 6-34 



dollar sign ($), final 

message specification 6-7 

dot (•), current message 

specification 6-15 

dot (•), current message 

specification 6-7 

dot option 6-28 

dot option 6-39 

dp command 6-17 

dp command 6-34 

e command 6-21 

e command 6-34 

echo command 6-34 

editor escape See e 

escape 

editor escape See v 

escape 

EDITOR string 6-29 

EDITOR string 6-39 

entry 6-9 

equal sign (s), message 

number printing 6-16 

equal sign (s), message 

number printing 6-34 

escape string 6-29 

escape string 6-39 

exclamation point (!) 

network mail 6-13 

shell command 

execution 6-21 

shell command 

execution 6-25 

shell command 

execution 6-34 
exit 

q command 4-28 

q command 6-17 
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q command 6>36 

q command 6-M 

q command 6-9 

X consnand 6-18 

X command 6-34 
f command 6-11 
f command 6-12 
f command 6-19 
F command 6-20 
f command 6-35 
fi command 6-35 
file switch See -f option 

files designated 6-33 
forwarding 

messages not 

deleted 6-17 

procedure See F 

command 
h command 6-16 
h command 6-35 
h comnand 6-9 
H flag, message saving 6- 
17 
header 

characteristics 6-16 

command See h command 

defined 6-8 

display 6-3 

display 6-8 

display 6-9 

listing 6-35 

windows 6-16 

windows 6-8 
heading 

compose escapes 6-23 

composition 6-5 



help command (?) 6-14 
help command (?) 6-3 
help escape ( ?) 6-11 
help escape ( ?) 6-22 
help escape ( ?) 6-37 
ho command 

description 6-19 

H flag 6-17 

message saving 6-35 
hold command See ho 
Qoamand 

ignore switch See -i 
option 
INTERRUPT key 

message abortion 6-11 

message abortion 6-28 

recipient list 6-27 
introduction 6-1 
invocation, -i option 6-9 
1 command 6-19 
1 command 6-35 
line killing 6-11 
line killing 6-6 
list command 6-35 
Ipr command 

-a option 6-32 

message printing 6-19 

message printing 6-35 
m command 6-19 
m command 6-35 
M flag, message saving 6- 
17 
mail command 

comnand mode entry 6-7 

command mode entry 6-9 
compose mode entry 6-11 
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help 6-3 

message reading 60IO 

message reading 6o3 

message sending 6-2 

message sending 6-35 
mail escapes See M 
escape 

mailbox See Mailbox 
mb command 6-18 
mb command 6-35 
mbox command See mb 
command 

mchron option 6-39 
message number 

command 6-1 6 

command 6-34 

message printing 6-10 

printing 6-16 

printing 6-3^ 

types 6-7 
message-list 

argument, multiple 

messages 6-12 

composition 6-7 

full message-list 

description 6-8 
message 

abortion 6-11 

abortion 6-28 

abortion 6-9 

advancement 6-10 

advancement 6-3^ 

body 6-6 

composition 6-5 

deletion M-28 

deletion 6-11 

deletion 6-17 



deletion 6-3U 

deletion 6-^1 

deletion 6-7 

deletion undoing 6-17 

description 6-5 

display M-28 

editing 6-11 

editing 6-21 

editing 6-31 

editing 6-3^ 

file inclusion 6-24 

forwarding See 

forwarding 

header See header 

heading See heading 

insertion into new 

message 6-25 

list See message-list 

listing 6-3 

number See message 

number 

printing See printing 

range description 6-7 

reading 6-10 

reading 6-3 

reading into file 6-9 

reply See reply 

saving See saving 

sending See sending 

size 6-21 

size 6-36 

specification 6-12 

undeletion 6-11 
metacharacters 6-15 
metacharacters 6-7 
metoo option 6-28 
metoo option 6-39 
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minus sign (-), message 

advancement 6-3^ 

network mail 6-13 

noisy phone line 6-9 

nosave option 6-28 

nosave option 6-39 

number command See message 

number 

options 

See also Specific 

Option 

command line 

options 6-31 

setting 6-13 

summary 6-39 

switch option 

setting 6-20 
organization 6-32 
p command 

message printing 6-14 

message printing 6-36 

message printing 6-M 

message printing 6-7 

syntax 6-8 
page option 6-29 
per iod ( . ) , dot use See 
dot (.) 

phone line noise 6-9 
plus sign (•*■), message 
advancement 6-34 
printing 

command See Ipr 

command 

command See p command 

escape See p escape 

lineprinter See Ipr 

command 



procedure 6-10 

procedure 6-7 

top five lines See t 

command 
programs designated 6-33 
prompt 4-28 
prompt 6-3 
Q command 

exit 4-28 

exit 6-17 

exit 6-36 

exit 6-4 

exit 6-9 

message abortion 6-28 
question mark (?) 

command summary 

printing 6-34 

compose escape help See 

help escape ( ?) 

help command 6-14 
quiet option 6-28 
quiet option 6-40 
R command 

alias effect 6-13 
r coimnand 

compose mode entry 6-11 

message reply 6-11 
R command 

message reply 6-12 
r command 

message reply 6-19 

message reply 6-36 

read escape See d escape 

read escape See r escape 
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reading 4-28 
recipient list, name 
addition 6-23 
record string 6-29 
record string 6-UO 
reminder service 4-30 
reminder service 6-32 
Reply conn and See R 
command 

return receipt request 
field 6-5 
8 command 

flag 6-16 

message saving 6-18 

message saving 6-36 

syston mailbox, message 

deletion 6-17 
saving 

asterisk (•) 

notation 6-18 

automatic 6-17 

command See s command 

flag 6-16 

ho command 6-35 

M flag 6-17 

message display 6-4 

s command 6-18 

s command 6-36 

system mailbox 6-9 

w command 6-18 

w command 6-37 
se command See set 
command 
sending 4-27 

cancellation 

impossible 6-3 

multiple recipients 6- 

10 



network mail 6-13 

procedure 6-10 

to self 6-2 
session abortion 6-11 
set command 

description, use 6-20 

description, use 6-36 

option control 6-39 
set options defined 6-27 
sh command 6-21 
sh command 6-36 
shell commands 6-21 
shell escape ( I) 6-25 
shell escape ( !) 6-25 
SHELL string 6-29 
SHELL string 6-40 
si command 6-21 
si command 6-36 
so command 6-22 
so command 6-36 
source command See so 
command 

special characters See 
metacharacters 
startup file 6-27 
string option 

setting 6-20 

summary 6-39 
subject escape See s 
escape 

subject field 6-4 
subject field 6-5 
subject switch See -s 
option 

subject switch See 
asksubject option 
switch See Option 



1-37 



XENIX User's Guide 



system composition 6-33 
system mailbox, message 
retention 6-9 
t command 

message top 

printing 6-12 

message top 

printing 6-16 

message top 

printing 6-36 

toplines option 6-16 
tilde escapes See compose 
escapes 

tilde quote escape 
( ) 6-26 

tilde quote escape 
( ) 6-37 
to field 

mandatory 6-5 

R command effect 6-12 
top conmiand See t coimnand 

toplines option 6-40 

toplines string 6-30 

u command 6-11 

u command 6-17 

u command 6-36 

u command 6-7 

undeletion See u command 

unset command 
description, use 6-20 
description, use 6-37 
option control 6-39 

V command 6-21 

V command 6-37 

V command 6-7 
variable See MAIL 
variable 



vertical bar ( I ) escape 
See shell escape ( !) 
VISUAL string 6-29 
VISUAL string 6-40 
w command 
message vrrite out 6-18 

message write out 6-37 
system mailbox, message 
deletion 6-17 
write escape See w 
escape 

write out See w command 
X command 
exit 6-18 
exit 6-34 

session abortion 6-11 
you have mail message 2-1 

! See shell escape ( I) 

: See command escape 
( :) 

? See help escape ( ?) 

b escape 6-23 

bcc escape 6-38 

c escape 6-23 

cc escape 6-38 

d escape 6-24 

dead escape 6-38 

e escape 6-23 

editor escape 6-38 

h escape 6-24 

headers escape 6-38 

N escape 6-25 

message escape 6-38 

p escape 6-22 

print escape 6-38 

quit escape 6-38 
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r escape 6-24 
read escape 6-38 
8 escape 6-23 
subject escape 6-38 
t escape 6-23 
to escape 6-38 
V escape 6-23 
visual escape 6-38 
w escape 6-25 
write escape 6-38 
I See shell escape ( I ) 
See tilde quote escape 
( ) 
Mailbox 
cleaning out 6-32 
command 6-18 
reading in 6-9 
system mailbox 6-5 
user mailbox 
filename 6-5 
message saving 
notation 6-17 
Make directory See mkdir 

command 
Marking See Ed 
mb command See Mail 
mbox command See Mail 
mchron option 

mail 6-39 
mesg option See Vi 
Metacharacter 

asterisk (») 7-54 
brackets (t3) 7-54 
directory name use 
avoidance 7-3 
escape 7-4 
list designated 7-54 



mail 6-15 

mail 6-7 

question mark (?) 7-54 

redirection 

restriction 7-6 
metoo option See Mail 
Minus sign (-) 

BC 

subtraction operator 

symbol 8-4 

unary operator symbol 

8-16 

unary operator symbol 

8-4 

mail, message 

advancement 6-34 

redirection effect 7-36 

subtraction operator 

symbol 8-4 

variable conditional 

substitution 7-38 
mkdir command 4-13 
MKFILES shell procedure 7- 

49 
more command 4-5 
Move See mv command 
fliltiple way branch See case 

command 
Multiplication See BC 
mv command 4-7 
mv command 4-8 

directory moving 4-13 
n command See Vi 
Name grammar 7-52 
Name special file 4-16 
Named pipe 4-16 
newgrp command 

description 7-30 
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shell built-in command 7- 

MO 

special shell command 7-30 

Newline substitution See 

Ed 
next command See Vi 5-44 
nohup command 7-19 
nosave option See Mail 
nu command See Vi 5-24 
Null command See Colon 

command ( : ) 
NULL shell procedure 7-50 
Number sign (#), comment 

symbol 7-54 
Operator See BC 
Option 

See also Specific Option 

configuration 3-9 

DRAFT shell procedure 7-46 

grouping 3-9 
invocation flags 7-39 
mail options See Nail 
multiple options 
grouping See grouping 

separate listing 3-10 

position 3-9 

tracing, $- variable 7-14 
Options 

terminal 4-4 

vi options See Vi 
Or-if operator (11) 

command list 7-19 

description, use 7-20 

designated 7-54 



Ordinary file See File 
Output 

append symbol ( 

»» 7-5 

»» 7-54 
appending 

procedure 3-1 1 

symbol (»») 3-11 
control 4-4 
creation symbol ( 

» 7-54 
diagnostic output file 7-5 

error redirection 7-37 

grammar 7-52 

redirection 2-3 

redirection 4-7 

redirection See 

Redirection 

resumption 4-4 

standard error file See 

diagnostic output file 

standard output file 7-5 

terminal screen 

destination 3-10 

to file 2-3 
p command 

ed use See Ed 

mail 
message printing 6-14 
message printing 6-36 
message printing 6-4 
message printing 6-7 
syntax 6-8 
page option See Mail 
Parent directory 

description 3-6 
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shorthand name 3-6 
Parentheses (()) 
BC 

expression enclosure 

8-15 

function identifier 

argument enclosure 8- 

14 
command grouping 7-25 
command grouping 7-40 
command grouping 7-54 
pipeline t command list 
enclosure 7-20 
^•st command operator 7-34 

passwd command 4-2 
Password 
changing 4-2 
logging in 2-1 
new user 2-1 
PATH variable 
conditional 
substitution 7-39 
description 7-12 
directory search 

effect 7-42 

sequence change 7-3 
Pathname 
absolute pathname 

example 3-5 

required 3-4 

slash (/) 

significance 3-5 

unique to system 3-4 
defined 3-5 

full pathname See absolute 
pathname 



relative pathname 
defined 3-5 
example designated 3-6 

structure 3-5 
Pattern matching facility 

cancellation 3-8 

case command 7-22 

characters 3-7 

description 3-6 

expr command argument 

effect 7-35 

grep command 4-21 

limitations 7-3 

metacharacter See 

Metacharacter 

redirection 

restriction 7-6 

shell function 7-3 

variable assignment, not 

applicable 7-11 
Pattern 

grammar 7-52 

metacharacter 7-54 
Percentage sign (%), BC 

modulo operator symbol 

8-4 
Period (.) 

ed use See Ed 

filename use 3-4 

pattern matching facility 

restrictions 7-3 

vi See Vi 

working directory 

change 4-15 
Permission types 4-16 
Permission 

block special device 

notation 4-16 
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change 3-2 

denial notation 4-16 

directory permission 

assignment 3-2 

change 3-2 

change 4-17 

combinations 

designated 4-17 

file creation, deletion 

notation 4-16 

file listing 

notation 4-16 

notation 4-16 

search notation 4-16 

search permission 4-19 

write permission 3-2 
execute notation 4-16 
file permission 

change 3-1 

denial notation 4-16 

execute permission 4-16 

file creation, deletion 

notation 4-16 

file listing 

notation 4-16 

file protection 3-1 

notation 4-16 

read notation 4-16 

required 3-1 

write notation 4-16 
listing 4-15 
notation 4-16 
read notation 4-16 
search notation 4-16 
symbols designated 4-16 
user class 
specification 4-18 



write notation 4-16 
PHONE shell procedure 7-50 
PID 

It variable 7-14 

$$ variable 7-13 

process identification 

number 4-24 

process identification 

number 4-26 
Pipe 

compose escapes See Mail 

file interchange 7-46 

function 3-12 

Ipr command 4-27 

procedure 3-12 

symbol (!) 3-12 

symbol (j) 7-54 
Pipeline 

command list 7-20 

defined 3-12 

diefined 7-19 

description 7-7 

DISTINCT 1 shell 

procedure 7-45 

filter 7-7 

grammar 7-52 

notation designated 7-7 

procedure 7-7 
Plus sign (•»•) 

BC 

addition operator 

symbol 8-4 

unary operator symbol 

8-16 

mail* message 

advancement 6-10 

mail, message 

advancement 6-34 
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variable conditional 
substitution 7-38 
Positional parameter 
description 7-10 
direct access 7-17 
null value assignment 7-38 

number yield, $# 

variable 7-13 

parameter substitution 7- 

11 

positioning 7-10 

prefix ($) 7-11 

setting 7-10 

variable assignment 

statement positioning 7-10 

pr command 4-27 

Print working directory See 

pwd command 
Printing 

command See Ipr command 

command See p command 

command See pr command 

ed See Ed 

mail See Mail 
Process identification 

number See PID 
Process 

background See Background 

process 

defined 7-1 

foreground See Foreground 

process 

number See PID 

status 

status 4-26 



Program stopping 2-5 
Prompt character 2-1 
Prompt character 4-1 
ps command 4-24 
ps command 4-26 
PS1 variable 7-12 
PS2 variable 7-13 
pwd command 4-11 
pwd command 4-14 
q command 
ed exit See Ed 
mail 

exit 4-28 
exit 6-17 
exit 6-36 
exit 6-4 
exit 6-9 

message abortion 6-28 
q! See Vi 
Question mark (?) 
directory name, use 
avoidance 7-3 
ed use See Ed 
filename, use 
avoidance 3-4 
mail 

command summary 
printing 6-34 
compose escape 
listing 6-11 
compose escape 
listing 6-2 
compose escape 
listing 6-22 
help command 6-14 
help command 6-3 
metacharacter 7-3 
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metacharacter 7*54 

pattern matching See 

metacharacter 

patter nnnatching 

functions 3-8 

single character 

representation 3-8 

variable conditional 

substitution 7-38 
quiet option See Mail 
quit command 

See also q command 

BC exit 8-1 

BC exit 8-3 
QUIT key, background process 

imnunity 7-19 
Quit See q command 
Quotation marks, back C*) 

command line 

substitution 7-8 

command substitution 7-M 

command substitution 7-9 

quoting 7-55 
Quotation marks, double (\0 
Quotation marks, double (\0 
Quotation marks, double (\0 
Quotation marks, double (\0 
Quotation marks, double (\0 
Quotation marks, double (\0 
Quotation marks, single (**) 

filename, use 

avoidance 3-4 

grep command 4-21 

metacharacter escape 7-4 

pattern matching 

cancellation 3-8 

trap command 7-27 



variable substitution 

inhibition 7-11 
Quoting 

backslash (\) use 7-55 

metacharacter escape 7-4 

quotation marks, back C^) 

use 7-55 

quotation marks, double 

( 7-55 
r character, read permission 

notation 4-1 6 
R command See Nail 
r commaid 

ed use See Ed 

mail use See Mail 
read command 

exit status 7-30 

shell built-in command 7- 

40 

special shell command 7-30 

Read command 

vi See Vi 
Read See r command 
Re ad -ahead 2-4 
readonly command 

description 7-30 

shell built-in command 7- 

40 

special shell command 7-30 

Record string See Mail 
Redirection 

argument location 7-8 

case command 7-26 

cd arg command 7-30 

control command 7-26 
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diagnostic output 7-6 
file descriptor 7-37 
for command 7-26 
if command 7-26 
input redirection 

procedure 3-12 

symbol (<) 3-12 
minus sign (-) effect 7-36 

output redirection 4-7 
symbol (») 3-11 

pattern matching use 

restriction 7-6 

simple command line, 

appearance 7-19 

special character use 

restriction 7-6 

special shell command, 

restriction 7-29 

symbol (<) 7-5U 

symbol ( 
» 2-3 
>) 7-54 

until command 7-26 

while command 7-26 
Reference Manual 

directory removal 

information 4-13 

linking information 4-10 

sort command 

information 4-21 

stty information 4-4 
Regular expressions See Ed 
Relative pathname See 

Pathname 
Reminder service 

automatic 4-30 



mail 6-32 
Remove directory See rmdir 

command 
Remove See nn command 
Removing a directory 4-13 
Renaming a file 4-8 
Repeat command 

see Vi 5-42 
reply command See Mail 
Report option See Vi 
Reserved word listing 7-55 
Return code See $? 

variable 
RETURN key 

BC 8-2 

command execution 2-2 

command execution 4-4 

command-line buffer 

submittal 3-9 

mail, message display 4-28 

rm command 2-3 
rm command 4-9 
rmdir command 4-13 
s command 

ed use See Ed 

mail 6-16 

mail 6-17 

mail 6-18 

mail 6-36 
scale command 8-7 
Scale See BC 
Screen See Scrolling 

screen 
Screen See Terminal screen 
Screen-oriented commands See 

Vi 5-12 
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Scripts See Ed 
Scripts See Shell 
Scrolling commands 

more 4-5 
Scrolling screen 

stopping U-1 
Scrolling, control 4-4 
se command See set command 
Search permission See 

Permission 
Search See Ed 
Search strings 

example designated 3*10 
Searching for a file 4-9 
Searching See / command 
Searching See Vi 
Searching 

vi procedure See Vi 
sed command See Ed 
Semaphore 4-16 
Semicolon (;) 

BC, statement separation 

8-19 

BC, statement separation 

8-3 

case command break 7«>22 

case delimiter symbol 7-54 

command list 7-19 

command separation 3*9 

coimnand separator 

symbol 7-54 

ed use See Ed 
set all See Vi 
set command 

mail 

description, use 6-20 



description, use 6-36 
option control 6-39 

name-value pair 

listing 7*16 

positional parameters 

setting 7*10 

shell built-in command 7* 

40 

shell flag setting 7*15 

special shell command 7*30 

sh command 

description 7-1 

mail 6-21 

mail 6-34 

mail 6*36 

shell invocation 7*16 
Shell command 

executing while in vi 5*14 

SHELL string 6-29 
SHELL string 6-40 
Shell 

-€ option 7-33 

-k option 7-33 

-n option 7*33 

-t option 7*33 

-u option 7*33 

*v option 7*15 

-X option 7*15 

argument passing 7*17 

command interpretation 3-9 

conmand 

search procedure 7*2 
special command See 
special command 
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compose escapes See Mail 
conditional capability 7- 
20 
creation 

procedure 7-1 
description 7-1 
echo command ^-20 
entry, mail mode 
source 6-21 
escape 

ed procedure See Ed 

mail procedure See 

Mail 
execution 

flag See option 

sequence 7-18 

termination 7-25 
exit 

-e option 7-33 

-t option 7-33 

mail mode return 6-21 

procedure 7-25 
function 7-1 
grammar 7-52 
in-line input document 
handling 7-36 
interactive 7-39 
interruption procedure 7- 
27 
invocation 

option 7-39 

procedure 7-16 
mail 

invocation 6-6 

shell commands 6-21 
option 

See also Specific 

Option 



designated , use 7-32 

setting 7-15 
pattern matching facility 
See Pattern matching 
facility 

positional parameter See 
Positional parameter 
procedure 

See also Specific Shell 

Procedure 

advantages over C 

programs 7-32 

byte access reduction 

consideration 7-^1 

creation 7-31 

description 7-2 

directory 7-32 

efficiency analysis 7- 

i|0 

efficiency 

awareness 7-40 

examples designated 7- 

M3 

filter order 

consideration 7-^1 

option See option 

scripts designation 7- 

M3 

time command 7-^0 

writing strategies 7-39 

redirection ability 7-5 
scripts See procedure 
special command 

See also Specific 

Special Command 

designated 7-29 
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redirection 
restriction 7-29 

special shell variable 7- 

18 

state 7-1^ 

string See SHELL string 

TERM variable See TERM 

variable 

variable See Variable 
shift connand 

argument processing 7-17 

shell built-in comnand 7- 

40 
si coranand See Mail 
Simple command See Command 
Single quotation marks See 

Quotation marks, single 

(") 
Slash (/) 

absolute pathname 

significance 3-5 

BC, division operator 

symbol 8-4 

connand prepending 

suppression 7-2 

ed use See Ed 

pathname significance 3-5 

search command See Vi 
so command See Mail 
sort command 4-20 
Special character See 

Metacharacter 
Special character 

ed use See Ed 

pattern matching 

facility 7-3 
Special characters 

designated 3-7 



pattern matching 3-6 
Special file 

description 3-2 
Sshared data file 4-16 
Standard error file See 

Output 
Standard error output See 

Error output 
Standard input file See 

Input 
Standard output file See 

Output 
Star (») 

See also Asterisk (*) 

ed metacharacter See Ed 
Status 

command See ps command 

information procedures 4< 

25 
String option See Mail 
String variable 7-10 
String 

searching for See Search 
stty command 4-4 

terminal setting 2-4 
Subdirectory 4-15 
Subshell, directory 

change 7-14 
Substitution command See s 

command 
Subtraction See BC 
Subtraction See 

Calculation 
Switch See Option 
Switch 

defined 3-9 

regulations See Option 
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System 

basic concepts 3-1 

characteristics 1-1 

composition 1-1 

mailbox See Mailbox 

tree-structured directory 

system 3-2 
t command 

ed use See Ed 

mail 6-12 

mail 6-16 

mail 6-36 
Table command See Ed 
Tabs 

ed See Ed 
tail command 4-6 
tbl command See Ed 
Temporary file 

directory (/tmp) 4-25 

kill command warning 4-25 

trap command* removal 7-28 

use recommendation 7-13 
term option See Vi 
TERM variable, changing 4-3 
Terminal screen 

output See Output 

scrolling screen See 

Scrolling screen 
Terminal 

changing 4-3 

name designation 2^2 

options setting 4-4 

strange behavior 

remedy 2-4 

writing to See vrrite 

command 



Terminals 

supported 4-3 
terse option See Vi 
test command 

argument 7-35 

brackets ([]) use in lieu 

of 7-33 

description, use 7-33 

operators 7-34 

options 7-34 

shell built-in command 7- 

40 
Text editor 

ed See Ed 

ex See Ex 

vi See Vi 
TEXTFILE shell 

procedure 7-51 
then clause See if command 
Tilde escape See Mail 
time command 7-40 
Top command See t command 
Toplines option See Mail 
Toplines string See Mail 
Transfer command See t 

comnand 
trap command 

description, use 7-27 

implementation method 7-29 

multiple traps 7-29 
special shell command 7-30 

temporary file removal 7- 

28 
troff See Ed 
true command 7-36 
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tty, terminal system 

name 2-2 
Type-ahead 2-4 
Type-ahead 4-4 
Typing error correction 2-3 
u command See vi 5-40 
u command 

ed use See Ed 

mail 6-17 

mail 6-36 

mail 6-7 

vi See Vi 
ugo, permission 

classification 4-18 
umask command 

description 7-31 

directory permission 

change 3-2 

shell built-in command 7- 

40 

special shell command 7-31 

Undo command See u command 
Undo command See Vi 
undo command See Vi 5-40 
unset command See Mail 
until command 

continue command 

effect 7-24 

description* use 7-23 

exit status 7-23 

redirection 7-26 

shell built-in command 7- 

40 
User classes 4-17 
User 

addition 2-1 



classification 4-18 
mail See Mail 
mailbox See Mailbox 
permission See Permission 

V command 

ed use See Ed 

mail 6-21 

mail 6-37 

mail 6-7 
Value See $? variable 
Variable 

$! variable 7-14 

$« variable 7-13 

$$ variable 7-13 

$- variable 7-14 

$? variable 7-13 

assignment 

line command 7-9 
string value 7-10 

BC variable See BC 

command environment 

composition 7-15 

conditional 

substitution 7-37 

description 7-9 

double quotation marks 

( 7-11 

enclosure 7-11 

execution sequence 7-10 

expansion 7-4 

export 7-13 

expr command 7-35 

file creation 7-27 

global check 7-33 

HOME See HOME variable 

IFS See IFS variable 
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keyword parameter T-IS 

listing procedure 7-16 

MAIL See NAIL variable 

name defined 7-10 

null value assignment 

procedure 7-37 

PATH See PATH variable 

positional parameter See 

Positional parameter 

prefix ($) 7-11 

PS1 See PS1 variable 

PS2 See PS2 variable 

set variable defined 7-37 

special variable 7-13 

string value 

assignment 7-10 

substitution 

-u option effect 7-33 

double quotation marks 

( 7-11 

notation 7-5^ 

redirection 

argument 7-6 

single quotation marks 

(••) 7-11 

space 

interpretation 7-11 
test command 7-33 
types designated 7-12 
Vertical bar (!) 
mail escape 6-25 
or-if operator symbol 
(II) 7-19 
pipe symbol 3-12 
pipeline notation 7-7 
Vi, mail 
compose escape, v 6-38 



Vi 



editing 6-21 

entry from coonand 

mode 6-7 

entry from compose 

mode 6-7 

VISUAL string 6-40 

• command See dot (•) 
command 

• ccMnnand 

See dot (•) command 
.exrc file 5-5M 
•login file 

terminal type setting 

use 5-50 
•profile file 

terminal type 

setting 5-50 
/ command 

searching 5-9 
command 

cursor movement 5-5 
:q! 5-16 
;x 5-16 

:x command 5-42 
appending text 

A 5-21 

See also inserting 

text 
args command 5-'(5 
b command, cursor 
movement 5-5 
breaking lines 5-26 
buffers 

delete 5-33 

delete See delete 

buffer 
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naming 5-23 

selecting 5-23 
C coimn&rjd 5-30 
C shell 

prompt 5-50 

TERM variable 5-50 

terminal type 

setting 5-50 
canceling changes 5-43 
caret C), pattern 
matching 5-39 
caret C*) , pattern 
matching 5-40 
cc command 5-31 
CNTRL-B 

scrolling 5-5 
CNTRL-D 

scrolling 5-5 

subshell exit 5-48 
CNTRL-F 

scrolling 5-5 
CNTRL-G 

file status 

information 5-11 

file status 

information 5-47 
CNTRL-J, inserting 5-26 
CNTRL-L 

screen redraw 5-48 
CNTRL-Q, inserting 5-26 
CNTRL-S, inserting 5-26 
CNTRL-0 

deleting an 

insertion 5-28 

scrolling 5-5 
CNTRL-V, use 5-26 
CO (copy) command 5-24 



colon (:) 
line-oriented command, 
use 5-12 
status line prompt 5-12 

command mode 
cursor movement 5-5 
entering 5-3 

command 

line-oriented See line- 
oriented commands 5-12 

repeating, dot (•) 

use 5-6 

screen-oriented See 

screen-oriented 

commands 5-12 
control characters, 
inserting 5-26 
copying lines 5-24 
correcting mistakes 5-21 
crash, recovery 5-48 
current line 

deleting 5-28 

deleting 5-6 

designated 5-2 

line containing 

cursor 5-4 

number, finding out 5- 

24 
cursor movement 

$ key 5-19 

•♦' key 5-19 

b 5-18 

backward 5-19 

BKSP 5-17 

by character 5-17 
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by lines 5-19 

by words 5-18 

CNTRL-N 5-19 

CNTRL-P 5-19 

down 5-17 

down 5-5 

e 5-18 

F 5-17 

forward 5-19 

h 5-17 

H 5-19 

j 5-17 

J 5-19 

k 5-17 

k 5-19 

keys 5-5 

1 5-17 

L 5-19 

left 5-17 

left 5-18 

left 5-5 

line beginning 5-5 

line end 5-5 

LINEFEED key 5-19 

lower left screen 5-5 

M 5-19 

RETURN key 5-19 

right 5-17 

right 5-18 

right 5-5 

screen 5-19 

scrolling See 

scrolling 5-5 

See also scrolling 

SPACEBAR 5-17 

T 5-18 

to end of file 5-5 



up 5-17 

up 5-5 

upper left screen 5-5 

w 5-18 

word backward 5-5 

word forward 5-5 
cursor movment 

right 5-17 
cw conunand 5-30 
D comsand 5-6 
d$ command 5-6 
dO command 5-6 
date, finding out 5-14 
dd command 5-6 
delete buffer 

use 5-33 
deleting text 

by character 5-27 

by line 5-27 

by word 5-27 

D 5-27 

dd command 5-27 

deleting an 

insertion 5-28 

dw command 5-27 

methods 5-6 

repeating deletion 5-M2 

undoing 5-^0 

undoing deletion 5-** 

X command 5-27 
demonstration 5-1 
description 5-1 
dollar sign ($) 

cursor movement 5-5 

pattern matching 5-39 
dollar sign($) 

use in line address 5- 
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28 
dot (•)coinmand See • 
conmand 5«-6 
dot See also dot (•) 
command 

dot» use in line 
address 5-28 
dw command 5-6 
editing several files 

changing the order 5-^)5 

end-of-line 

displaying 5-51 
entering 

at a specified line 5- 

17 

at a specified word 5- 

17 

procedure 5-2 

with filename 5-16 

with several 

filenames 5-43 
error messages 

shortening 5-52 

turning off 5-it6 
ESCAPE, insert mode 
exit 5-3 

ESCAPE, in£<eft mode 
exit 5-48 
exclamation point (I) 

shell escape 5-14 
exiting 

:q! 5-16 

u 5-16 

:x command 5-42 

saving changes 5-42 

saving file 5-13 



temporarily 5-14 

temporarily 5-46 

without saving 

changes 5-43 

ZZ command 5-43 
file 

creating 5-2 

not saving, :q! 5-16 

saving 5-16 

status information 

display 5-10 

status information 

procedure 5-1 1 
filename 

finding out 5-47 

planning 5-44 
G command 

cursor movement 5-5 
goto command See G 
comnand 
H' ccmmand 

cursor movement 5-5 
i conmand 

inserting text 5-2 
ignorecase option 5-36 
ignorecase option 5-51 
insert command See i 
command 
insert mode 

entering 5-3 

exiting 5-3 
inserting text from 
another file 5-14 
inserting text 

See also appending 

text 

control characters 5-26 
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froB other files 5-22 

i 5-21 

repeating insert 5-22 

repeating insert 5-42 

undoing 5-^0 

undoing insert 5-M8 

undoing insertion 5-4 
invoking See entering 
j command 

cursor movement 5-5 
joining lines 5-26 
k command 

cursor movement 5-5 
L command 

cursor movement 5-5 
leaving See exiting 
line addressing 

dollar sign 5-28 

dote.) 5-28 

procedure 5-28 
line numbers, displaying 

:nu command 5-48 

linen umber option 5-15 

linenumber option 5-24 

linenumber option 5-52 

nu command 5-24 
line-oriented command 
mode 5-47 
line-oriented commands 

:args 5-45 

:e 5-23 

:e 5-45 

:e# 5-23 

:e# 5-46 

:f 5-47 

:file 5-47 

;n 5-44 



:nu 5-24 

:nu 5-48 

:q 5-43 

:r 5-22 

:rew 5-45 

:s 5-31 

:w 5-22 

:wq 5-42 

colon (:) use 5-12 

deleting text 5-27 

entering 5-12 

moving text 5-31 

status line, 

display 5-10 
linenumber option 5-52 
list option 5-51 
magic option 5-40 
magic option 5-53 
marking lines 5-23 
mesg option 5-53 
mistakes, correcting 5-21 
mode, determining 5-48 
mode 

See also command node 

See also insert mode 

See also line-oriented 

command mode 
moving text 5-31 
n command 5-10 
n conuaand 5-36 
new line, opening 5-22 
next coiunand 5-44 
opening a new line 5-22 
options 

displaying 5-51 

ignorecase 5-36 
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ignorecase 5-51 

linenunber 5-24 

linen umber 5-31 

linenumber 5-52 

list 5-15 

list 5-51 

magic 5-40 

magic 5-53 

mesg 5-53 

report 5-52 

setting 5-49 

setting 5-51 

terra 5-52 

terse 5-52 

warn 5-46 

warn 5-53 

wr apse an 5-36 

wr apse an 5-53 
over strike commands 5-28 
pattern matching 

See also searching 

beginning of line 5-39 

caret O 5-40 

character range 5-39 

character 9 single 5-39 

end of line 5-39 

exceptions 5-40 

generally 5-39 

special characters 5-40 

square brackets 

([]) 5-39 
period (•) 

pattern matching 5-39 

repeat command 

symbol 5-3 
problem solving 5-48 



putting 5-23 
Q comnandt line-oriented 
command mode 5-47 
quitting See exiting 5-43 
r comand 5-14 
r command 5-28 
read command 5-14 
redrawing the screen 5-48 
repeat command 5-42 
repeating a comnand 5-42 
replacing a line 5-30 
replacing a line 5-31 
replacing a word 5-30 
replacing a word 5-31 
report option 5-52 
rew command 5-45 
S command 5-29 
s command 5-30 
saving a file 5-43 
screen, redrawing 5-48 
screen-oriented 
commands 5-12 
scrolling 

backward 5-5 

down 5-20 

down 5-5 

forward 5-5 

up 5-20 

up 5-5 
searching and replacing 

a word 5-37 

c option 5-38 

choosing 

replacement 5-38 

command syntax 5-37 

p option 5-38 

printing 

replacement 5-38 
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searching See / command 
searching 

See also searching and 

replacing 

backward 5-35 

caret (*) use 5-39 

caret 5-39 

caret (") 5-40 

case signficance 5-51 

case significance 5-36 

dollar sign ($) 5-39 

forward 5-10 

forward 5-35 

next command 5-36 

period (.) 5-39 

procedure 5-9 

repetition 5-10 

special characters 5-36 

special characters 5-53 

square brackets 

(C3) 5-39 

status line* 

display 5-10 

wrap 5-10 

wrap 5-36 

wrap 5-53 
session, canceling 5-16 
set all, option list 5-15 
set command 5-49 
set coimnand 5-51 
setting options 5-51 
shell command, 
executing 5-14 
shell escape 5-46 
slash (/) 

search command 



delimiter 5-9 
special characters 

matching 5-40 

searching for 5-36 

searching for 5-53 

vi filenames 5-44 
status line 

line-oriented c<xmiand 

entry 5-12 

location 5-10 

prompt, colon (:) 

use 5-12 
string 

pattern matching 5-39 

searching for See 

searching 
sub shell 

exiting 5-48 
Substitute commands 5-29 
switching files 5-45 
system crash 

file recovery 5-49 
tabs 

displaying 5-51 
TERM variable 5-50 

Bourne shell 5-50 

Visual Shell 5-50 
termcap 5-50 
terminal type setting 

Bourne shell 5-50 

C shell 5-50 

how 5-52 

Visual Shell 5-50 
terse option 5-52 
time, finding out 5-14 
u command 5-4 
u command 5-40 
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u command 5-48 

undo coimnand See u 

command 

undoing a command 5-40 

w command, cursor 

movement 5-5 

warn option 5-46 

warn option 5-53 

warnings, turning off 5-53 

word, deleting 5-6 

wrapscan option 5-36 

wr apse an option 5-53 

write messages 5-53 

writing out a file 
:wq command 5-42 
:wq command 5-43 

X command 5-6 

yanking lines 5-23 

yanking lines 5-26 

ZZ command 5-43 
visual command See Mail 
Visual Shell 

TERM variable 5-50 

terminal type 5-50 
VISUAL string See Mail 
w character 

directory permission 

notation 4-16 

file permission, write 

notation 4-16 
w command See Vi 
w command 

ed use See Ed 



message saving 6-18 
message write out 6-37 



system mailbox, message 

deletion 6-17 
wait command 

description 7-31 

exit status 7-31 

shell built-in command 7- 

40 

special shell connand 7-31 

warn option See Vi 
wc command 4-22 

word count 3-13 
while comnand 

break command effect 7-24 

continue command 

effect 7-24 

description ff use 7-22 

exit status 7-23 

loop 7-44 

redirection 7-26 

shell built-in command 7- 

40 

test command 7-33 
who command 4-25 

description 2-2 

logged in users list 3-13 
Word 

counting See wc command . 

grammar 7-52 
Working directory See 

Current directory 
wrapscan option See Vi 
wrapscan option See Vi 5-36 
write command 4-28 
Write out See w command 
WRITEMAIL shell 

procedure 7-51 
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X character 
directory permission 
search M-16 

file permission, execute 
notation 4-16 
X command See Vi 
X command 
mail 

exit 6-18 
exit 6-34 

session abortion 6-11 
vi use See Vi 
z 

vi scroll 5-20 
ZZ command See Vi 5-43 
[] See Brackets ([]) 
{} command See Braces 

command ({}) 
bcc escape See Hail 
cc escape See Nail 
dead escape See Mail 
editor escape See Nail 
headers escape See Nail 
message escape See Nail 
print escape See Mail 
quit escape See Nail 
read escape See Mail 
subject escape See Mail 
to escape See Mail 
visual escape See Nail 
write escape See Nail 
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